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Only Microware's OS-9 

Operating System Covers 

the Entire 68000 Spectrum 



Is complicated software and expensive hardware 
keeping you back from Unix? Look into OS-9, the 
operating system fiom Microware that gives 68000 systems 
a Unix-style environment with much less overhead and 
complexity. 

OS-9 is versatile, inexpensive, and delivers outstanding 
performance on any size system. The OS-9 executive is 
much smaller and far more ef- 
ficient than Unix because it's 
written in fast, compact as- 
sembly language, making it 
ideal for critical real-time ap- 
plications. OS-9 can run on 
a broad range of 8 to 32 bit 
systems based on the 68000 
or 6809 family MPUs fiom 
ROM-based industrial con- 
troller up to large multiuser 
systems. 

OS-9S OUTSTANDING 

C COMPILER IS 
YOUR BRIDGE TO UNIX 
MkHAvare's C compiler tech- 
nology is another OS-9 advantage. The compiler produces 
extremely fast, compact, and ROMable code. You can easily 
develop and port system or application software back and 
forth to standard Unix systems. Cross-compiler versions for 



Key OS-9 Features At A Glance 
Compact (16K) ROMable executive written in assembly 
language 

User "shell" and complete utility set written in C 
C source code level compatibility with Unix 
Full Multitasking/multiuser capabilities 
Modular design - extremely easy to adapt, modify, or 
expand 

Unix-type tiee structuied file system 
Rugged "crash proof' file structure with lecoid locking 
Works well with floppy disk or ROM-based systems 
Uses haidwaie or softwaie memory management 
High performance C. Pascal, Basic and Cobol compilers 



VAX and PDP-11 make coordinated Unix/OS-9 software 

development a pleasure. 

SUPPORT FOR MODULAR SOFTWARE 
- AN OS-9 EXCLUSIVE 
Comprehensive support for modular software puts OS-9 

a generation ahead of other operating systems. It multiplies 

programmer productivity and memoiy efficiency. Applica- 
tion software can be built 
from individually testable 
software modules including 
standard "library" modules. 
The modular structure lets 
you customize and recon- 
figure OS-9 for specific hard- 
ware easily and quickly. 

A SYSTEM WITH 

A PROVEN 
TRACK RECORD 

Once an underground 
classic, OS-9 is now a solid 
hit. Since 1980 OS-9 has 
been ported to over a hun- 
dred 6809 and 68000 
systems under license to some of the biggest names in the 
business. OS-9 has been imbedded m numeious consumer, 
industrial, and OEM products, and is supported by many 
independent software suppliers. 
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UNIX 






ROM-BASED FLOPPY-DISK BASED DISK BASED SMALL SCAIE LAR6E-SCAU 
CONTROL PERSONAL RING TIMESHARING 
SYSTEMS COMPUTERS SYSTEMS SYSTEMS 

HAND-HELD HARDWARE SOFTWARE SINGLE USER MEDIUM SCALE 
COMPUTERS DEVELOPMENT SYSTEMS MULTITASK!'' TIMESHARING SYSTEMS 

SMALL SYSTEMS LARGE SYSTEMS 



ALL SYSTEMS INCLUDE: 

* The CLASSY CHASSIS with a terro-resonant. constanl vonage power 
supply that provides - 8 volts al 30 Amps. ♦ 16 vods at 5 Amps, and 

-16 volts al 5 Amps. 

* GoW plated bus connectors. 

* Double density OMA floppy disk controllers. 

* Complete hardware and software documentation. 

* Necessaiy cables, filler plates. 

YOU CAN EXPAND YOUR SYSTEM WITH: 

MASS ST0RA6E 

Dual 8" OSDO Floppies. Cabinet & Power Supply $169481 

20MB Streamer (underdevelopment) 

1.6MB Dual Speed Floppy .(under developmen I) 

MEMORY 

#67 Static RAM -64K NMOS (6809 Only) $349.67 

#64 Static RAM 64K CMOS w/ballery (6809 Only) 1396.64 

#72 256K CMOS Static RAM w/ballery 1998.72 

#31 16Socket PROM/ROM/RAM Board (6809 only) $268.31 

INTELLIGENT I/O PROCESSOR BOARDS 

significantly reduce systems overhead by handling routine I/O func- 
tions; freeing the host CPU lor running user programs. This improves 
overall system performance and allows user terminals to be run at up 
to 19.2K baud. For use with GMX 111 and 020 systems. 

#1 1 3 Port Sei iai-30 Pin (0S9) 1 4 98, 1 1 

#14 3 Port Serial-30 Pin (UnlFLEX) $498.14 

#12 Paiallel-50 Pin (UniFLEX-020) {538.12 

#13 4 Port Serial-SO Pin (0S9 & UniFLEX-020) $618.13 

I/O BOARDS (6809 SYSTEMS ONLY) 

#41 Serial. 1 Port . $88.41 

#43 Serial. 2 Port $128.43 

#46 Serial. 8 Port (0S9/FLEX only) $318.46 

#42 Parallel, 2 Port $88.42 

#44 Parallel, 2 Port (Centronics pinout) $128.44 

#45 Parallel. 8 Pen (0S9/FLEX only) $198.45 

CABLES FOR I/O BOARDS-SPECIFY BOARD 

#95 Cable sets 1 needed per port) $24.95 

#51 Cent. B.P. Cable lor #12 & #44 $34.51 

#53 Cenl. Cable Set $36.53 

OTHER BOARDS 

#66 Prototyping Board-SO Pin $56.66 

#33 Prototyping Board-30 Pin $38.33 

Windrush EPROM Programmer S30 (0S9/FLEX 6809 only) . . $545.08 

CONTACT QlMIX FOR FURTHER DETAILS ON THESE AND 
OTHER BOARDS AND OPTIONS. 

EXPORT MODELS: ADO $30 FOR SOHl. POWER SUPPLIES. 
ALL PRICES ARE F.O.B. CHICAGO. 

GIMIX DOES NOT GUARANTEE PERFORMANCE OF ANY GIMIX 
SYSTEMS. BOARDS OR S0F1WARE WHEN USED WITH OTHER 
MANUFACTURERS PRODUCT. 

GiMIX. Inc. reserves the right to change pricing, terms, and products 
specJficaUorts at any time whlmil further notice. 





GIMIX 2MHZ 6809 SYSTEMS 


GMX 68020 SYSTEMS 


operating 

Systems 

Included 


#49 

0S9GMXI/ 

and FLEX 


#39 

OS9GMXII/ 

and FLEX 


#79 

0S9 GMX III/ 

and FLEX 


#39 
UniFLEX 


#89 
UniFLEX III 


•020 
0S9/68O2O 


•020 
UniFLEX VM 


CPU included 


#05 


#05 


GMX III 


#05 


GMX III 


GMX 020 


GMX 020 * MMU 


Serial Ports 
Included 


2 


2 


3 Intelligent 


2 


3 Intelligent 


3 Intelligent 


3 Intelligent 


High Speed 
Stave RAM 


64KB 


256KB 


256KB 


256KB 


256KB 


512KB 


1 Megabyte 


PRICES OF 
SYSTEMS WITH: 
Dual 80 Track 
OSDO Drives 


$299849 


$3398.39 


$4898 79 


N/A 


N/A 


N/A 


N/A 


19MB Hard Disk 
and one 80 track 
Floppy Disk 


$5598.49 


$5998.39 


$7798.79 


$5998.39 


$8098 89 


$11,680.20 


$13.68020 


72 MB Hard Oisk 
and one 80 track 


$7598 49 


$7998.39 


$9798.79 


$7998.39 


$10.098 89 


$13.680 20 


$15,680.20 


a 72MB * a 6MB 
removable pack 
hard disk and one 
80 track floppy 


$909849 


$9498.30 


N/A 


$9498.39 


N/A 


N/A 


N/A 


a 72MB * a 12MB 
removable pack 
hard disk and one 
80 track floppy 


N/A 


N/A 


$11,298.79 


N/A 


$11,598.89 


$15,180.20 


$17,180.20 


GMX 6809 0S9/ 
FLEX SYSTEMS 
SOFTWARE 

0S9 » Editor. 
Assembler, Debugger 


GMXI 

Included 


GMX II 
Included 


GMX III 
Included 


TO ORDER BY MAIL SEND CHECK OR MONEY ORDER OR USE YOUR VISA OR MASTER 
CHARGE. Pfeua allow 3 weeks lor panoul checks k> dear US omen add S$ handl- 
ing If order Is under $200 00 Foreign orders add HO Handing If order is under 
1200 00 Foreign orders over 1200 00 WW be iNppW vtg Emery Air Fnlght COLLECT, 
and we wH charge no handing All orders must be prepaid m U.S. fundi PttlM not* 


FLEX 


Included 


Included 


Included 


mil kwgfl checks inn bam taking about 8 weeks lor u*ac*on so m would advte 
wiring money, or checks drawn on i sank account in the U S Our Dai* is tnt Connnen 
tal lUnob NaOorai Bank ot CNcago, 231 S LlStfe Street. CNcago. IL 60693. account 


GMXBUG Monitor 


Included 


Included 


Included 


Basic 09, RunB (0S9) 


Included 


included 


Included 


Alitor 73-32D33 


RMS (0S9) 


included 


Included 


Included 


BASIC M and OS •» ire taomirts of MIcrowOT Systems Corp. and MOTOROLA. Inc. 
FLEX and UniflfX are trademarks ol Technkai SrsfeflB Constants, inc GIMIX, 
GHOST. 6MX. Cl ASSY CHASSIS, in (rrfenans ol GIMIX. Inc. 


00 (0S9) 


Included 


Included 


Included 


VDisk tor FLEX 


N/A 


Included 


Included 


RAMDisk lor 0S9 


N/A 


$125 option 


Included 




0-FLEX 


N/A 


$250 Option 


Included 




Support ROM 


N/A 


N/A 


Included 


Gimix f * • KHi 


Hardware CRC 


N/A 


N/A 


Included 
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Available: Wide variety of languages and oiher software 
tor use with either OS-9 or FLEX. 

All GIMIX versions of 0S9 can read and write RS color 
computer format 0S9 disks, as well as Ihe 
Mrcroware/GIMIX standard format. 

Al) 0S9/FLEX systems allow you to software selecl either 
operating system. 



1337 WEST 37th PLACE 

CHICAGO, ILLINOIS 60609 

(312) 927-5510 . TVYX 910-221-4055 



198S GIMIX. INC B-eS 




Portions of the text for '68' Micro Journal ware 
prepared using the following furnished Hard/Software: 

OWVItHS - rvwVNAHE 

Southwest Techlncal Products 

219 W. Rhapsody 

San Antonio. TX 782I6__ _. , .„.,,,. 

S09 - 5/8 rJMF Disk - C0S1 - 821?" - Sprint J Printer 

GIMIX Inc. 

1337 West 37th Place 
Chicago, IL 60609 
Super Malnf 



nframe - 0S9 - FLEX - Assorted torsive 



EDITORS - WORD PROCESSORS 
Technical Systems Consultants, Inc. 
HI Providence Road 
Chapel HIM. MC 27914 
FLEX - Editor - Text Processor 

Great Plains Computer Co., Inc. 
PO Box 916 

Idaho Falls. ID 8 3401 
Stylograph - Mall Marge - Spell 

Editorial Staff 

Don Ml II lams Sr . Publisher 

Larry E. Williams Executive Editor 

Tom E, Williams Production Editor 
Robert L. Nay Technical Editor 
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Penny Wll I Isms Subscriptions 
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Send All Correspondence To: 

fawputer Publishing Oenfbr 

66* Micro Journal 

9900 Cassandra Smith Rd. 

Hlxson, Tn. 37343 

Phone (615) 842-4600 or Telex 558 414 PVT BTH 

Copyrighted 1983 by Computer Publishing Inc. 

68' Micro Journal Is published 12 times a year by 
Computer Publishing Inc. Second Class Postage Paid 
ISSN 0194-5025 at Hlxson, Tn . and additional entries. 
Postmaster: send form 3597 to 68' Micro Journal, P06 
849 Hlxson, Tn. 37343. 

Subscription Ratm 

I Tear S24.50 U.S.A., Canada 4 Mexico Add 19.50 a 
Year. Other Foreign Add SIZ a Year for Surface, 
Airmail Add 148 a Year. Must be In U.S. ct 



or Articles For Publication 



Articles submitted for publication should Include 
authors name, address, telephone number and date. 
Articles should be on either 5 or 8 Inch disk In 
STYLOGRAPH or TSC Editor format with 3.5 Inch Column 
■ Idth. All disks will be returned. Articles submitted 
on paper should be 4.5 Inches In width (Including 
Source Listings) for proper reductions. Please Use A 
Dark Rlbbonll No Blue Inklll Single space on 6X11 bond 
or better grade paper. No hand written articles 
accepted. Disks should be In FLEX2 6800 or FLEX9 
6B09 any version or 0S-9 any version. 

The following TSC Text Processor commands 0H.Y 
should be used: .sp space, .pp paragraph, .fl fill and 
-nf no fill. Also please do not format within the text 
with multiple spaces. We will enter the rest at time 
of editing. 

All STYLOGRAPH commands are acceptable except ,pg 
page command. We print edited text files In contlnous 
text form. 

Letters To The Editor 

All letters to the editor should comply with the above 
requirements and must be signed. Letters of ••gripes" 
as well as "praise" are solicited. We reserve the 
right to reject any submission for lack of "good 
taste" and we reserve the right to define "good 
taste". 

Advertising Rates 

Commercial advertisers please contact 68* Micro Journal 
advertising department for current rate sheet and 
requirements. 

Classified Advertising 

All classified ads must be non-commercial. Minimum of 
19.50 for first 20 words and .45 per word after 20. 
All classifieds must be paid In advance. f*> classified 
ads accepted over the phone. 
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..HEAR y£. HEAR 

OS-9 M 
User Notes 



By: Peter Dibble 
As Published in 68 Micro Journal 



The publishers of 68 Micro Journal are proud to announce Che 
publication of Peter Dibbles 0S9 PSKR MOTES . 

Informatics Cor the BEGINNER to the PRO, 
Regular or CoCo 0S9 

Ualng 0S9 
HELP, HINTS, PROBLEMS, REVIEWS, SUGGESTIONS, COMPLAINTS, 0S9 STANDARDS, 
Generating a New Bootstrap, Building a new System Disk, 0S9 Users Group, etc. 

Program interfacing to 0S9 
DEVICE DESCRIPTORS, DIRECTORIES, "FORKS", PROTECTION, "SUSPEND STATE", "PIPES", 

"INPUT/OUTPUT SYSTEM", etc. 

Programming Languages 
Assembly Language Programs and Interfacing; Basic09, C, Pascal, and Cobol 
reviews, programs, and uses; etc. 

Disks Include 
No typing all the Source Listings In. Source Code and, where applicable, 
assembled or compiled Operstlng Programs. The Source and the Diacuaslona In 
the Columns can be used "as is", or as a "Starting Point" for developing jnor 
OWN more powerful Programs. Programs sometimes uae multiple Languages such 
as a short Assembly Language Routine for reading a Directory, which is then 
"piped" to a Basic09 Routine for output formatting, etc. 




BOOK 



Typeset — w/ Source Listings 
(3-Hole Punched; 8x11) 



$9.95 



Deluxe Binder 



$5.50 



. .. a T . , . 1 8" SS, SD Disk - - 

All Source Listings on Disk 2 5- ss, dd Disks _ 



- - $14.95 

- - $24.95 



Shipping and Handling; $3.50 per Book, $2.50 per Disk Set 
* All Currency In U.S. Dollars Foreign Orders Add $4.50 S/H 

If paying by check - Please allow 4-6 weeks delivery 



Continually Updated In 68 Micro Journal Monthly 

Computer Publishing Inc. 

5900 Cassandra Smith Rd. 

Hixson, TN. 37343 



■Ms! 



TM - OS9 ta ■ trtdtmirk of Hicro«*r* Syal*M Corp. and Motorola Inc. 
TM - 6bT* Hlcro Journal la a trademark ol Coaputcr Puhll»rJng loc. 



(615) 842-4600 
Telex 558 414 PVT BTH 
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We Proudly Announce Che KUSTANG-020 Super SBC 
"The one with Che REAL KICK!" 

Only from DATA-COMP 

This Is Che NCC, world beacer GMX SBC, In a super 
configuradon. Daca-Comp has maced lc Co a 
power plus power supply/scyllsh cablnec and your 
choice of floppy and/or hard disk drives. 
Available In several different configurations. (1} 
single board. (2) single board and regulators for 
your cablnec or mainframe and power supply. (3) 
single board - power supply and cablnec - your 
disk drives. (4) single board - power 
supply/ cablnec - our drives configured Co your 
specs, and ready Co run. 0S9 68K. will be 
available as well as several other popular 
operating systems. Also all the popular 0S9 68K. 
software and Motorola 020-BUG will be available 
at a very reasonable price. 

Note: We will include the Motorola 020-BUG at no 
additional charge. This item alone sells for 
$500.00. This allows direct coding of 68020 
advanced codes. 020-BUG is required for our 
version of 0S9. Please bear in mind, this system 
is the one others are compared to. 

This system is the state-of-the-art star-ship. 
It runs rings around any other 68XXX SBC, and 
most mainframes. The speed and expanded RAM 
make this the "best buy" by a far stretch! A 
true multi-user, multi-tasking computer. So far 
advanced that even the experts don't call It a 
micro. Compared to the others, it isn't even a 
"horse race." And the price is certainly right. 
You can bet on this one I 

So, will It be Turtle or Thoroughbred? 

Deliveries expected to begin November 1985. 

CALL NOW FOR PRICE AND DELIVERY RESERVATIONS: 





Mustang-020 is trademark of Data-Comp-CPI 



DATA-COMP 

5900 Cassandra Smith Rd 
Hixson. TN 37343 



SHIPPING 

USA ADD 2X 

FOREIGN ADD 5* 

HIN. S2.SO 



(615)842-4600 

For Ordaflny 
TELEX SSI 414 fVT BTH 
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Mustang 020 Features 

12.5 KHi MC68020 full 12-alt vt4* path Proceiaor 

- 32-bit wide aoifmiltlplaied data 4 iddraaa buses 

- On-chip instruction cschc 

- Qbjsct-cods co«pstlbl with eerlier M6B000 family processor* 
(66000/68008/68010) 

- Enhanced Instruction let - Coprocessor Interfere 
Optional 68481 Floating point Coprocessor (12.5 M*U) 

- Dlract eitanaloa of 68020 Instruction aet 

- full support or DII P754, draft 10.0 

- Tranaeendentala and other sath functions 
2 Kagabytes or UM (5121 a i2-blt organUstlon) 
Up to 2561 bytea or U7UH (64K X 32-blta) 

- Uaaa four 2764, 27128, 27256, or 27)12 EP&OXa 
4 Aaynchrooous aerial 1/0 porta (2 % HC6868I DtlART) 

- Sortwara programmable baud rstes to 19.21 

- Standard 15-212 laterfsce 

- Optional network Interface on one port 
Buttered 8-blt Parallel 1/0 Port (1/2 MC68230) 

- Cent roalca-type parallel printer plnout 

- H«y alio bo uaad aa parallal lopul port 
Eepiesloo Connector tor Additional 1/0 Oovicee 

- 16-bll data path 

- 256 byte address apace 

- 2 tntarrupt loput s 

- Clock and Control Signals 
Tlae-of- ay Clock /Calendar w/ battery backup 
Controller for up to Two S 1/4" Floppy Dlik Crlves 

- Single or doobla aldad 

- Single or doubls deo»lly 

- 48 or 96 treefca per Inch (40/80 Track) 
Nounta IMrecriy to a Standard 5 1/4" Disk Drive 
3ASI Uttrface ror intelligent Hard Disk Controllara 
Frograaweble htriodlc tntarrupt Generator 

- for : law-slicing and real-tin* ippUcntam 

- Interrupt ratea front aleroaaconde to aeconda 

- Highly Accurate rlsebaae (5 PRO 
5-blt aanae switch, readable by the proceaaor 
Hardware atogle-step capability 

*** And asoy other advanced feature! not found on other ayareea 
priced auch higher. 

load Baale09: 
Teated Benchmark a 



Straight From The Horse's Mouth 

The Clear Winner 




(615)842-4600 



DRTR-COmP 
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FLEX ™ USER NOTES 

THE 6800-6809 BOOK 

By: Ronald W. Anderson 

As published in 68 MICRO JOURNAL" 

The publishers of 68 MICRO JOURNAL are proud to announce the publication of Ron Anderson's FLEX USER NOTES, in 
book torm. This popular monthly column has been a regular feature in 66 M ICRO JOURNAL SINCE 1 979. It has earned the 
respect of thousands of 68 MICRO JOURNAL readers over the years. In fact, Ron's column has been described as the 
Bible' for 68XX users, by some of the world's leading microprocessor professionals. Now all his columns are being 
published, in whole, as the most needed and popular 68XX book available. Over the years Ron's column has been one of 
the most popular in 68 MICRO JOURNAL. And of course 68 MICRO JOURNAL is the most popular 68XX magazine 
published. 

As a SPECIAL BONUS all the source listing in the book will be available on disk for the low price of : FLEX '* format only — 5" 
$12.95 — 8" $1695 plus $2.50 shipping and handling, if ordered with the book. If ordered separately the price of the disks 
will be: 5" $17.95 — 8" $19 95 plus $2.50 shipping and handling. 

Listed below are a few of the TEXT files included in the book and on diskette. 

All TEXT files in the book are on the disks. 



LOGO.C1 

MEMOVE.C1 

DUMP.C1 

SUBTEST.C1 

TERMEMC2 

M.C2 

PRINT.C3 

MODEM. C2 

SCIPKG.C1 

U.C4 

PRINT.C4 

SET.C5 

SETBAS1 C5 



File load program to offset memory — ASM PIC 
Memory move program — ASM PIC 
Printer dump program — uses LOGO — ASM PIC 
Simulation of 6800 code to 6809, show differences — ASM 
Modem input to disk (or other port input to disk) — ASM 
Output a file to modem (or another port) — ASM 
Parallel (enhanced) printer driver — ASM 
TTL output to CRT and modem (or other port) — ASM 
Scientific math routines — PASCAL 
Mini-monitor, disk resident, many useful functions — ASM 
Parallel printer driver, without PFLAG — ASM 
Set printer modes — ASM 
Set printer modes — A-BASIC 
(And many more) 



"Over 30 TEXT files included in ASM (assembler) — PASCAL — PIC (position independent code) TSC BASIC-C. etc. 

NOTE: C1,.C2. etc. -Chapter 1, Chapter 2, etc. 



This will be a limited run and we cannot guarantee that supplies will last long. Order 

Foreign Orders Add $4.50 S/H 
Softcover — Large Format 

Book only: $7.95 + $2.50 S/H 

With disk: 5" $20.90 + $2.50 S' 

With disk: 8" $22.90 + $2.50 S/H 

See your local S50 dealer/bookstore or order direct from: 

Computer Publishing Inc. 

5900 Cassandra Smith Rd. 

Hixson, TN 37343 

TELEX 558 414 PVT BTH (615) 842-4601 

"FLEX is a trademark ol Technical Systems Consultants 
6 November 'B5 



for early delivery 
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FLEX User Notes 



Ronald W. Anderson 
J!>40 Sturbridge Court 
Ann Arbor, Hi 48105 



Don Williams asked me to depart from 
the usual monthly column format for this 
month to tell you about the text editor 
that I have just finished writing. He intends 
to publish portions of the manual for PAT 
here, and the introduction goes into some of 
the reasons I wrote PAT, so I won't go into 
all that here, only to have it repeated. Let 
me just give you a little more in depth 
history of the project. As you may well 
know, 1 have been a software "critic" for a 
long time. Most of the suppliers have 
indicated that their initial reactions to m y 
reviews have been negative, but the majority 
of them seem to have grown to appreciate 
my comments on their new offerings, and 

fenerally they have included many of the 
eatures that I called "ought to"s when I 
wrote reviews. 

Of course, anyone who writes a lot of 
text, and also programs for a living, uses an 
editor a great deal of the time. I can't 
think of any one piece of software that I 
run more than an editor, by a very wide 
margin. I have always thought therefore, 
that an editor ought to be made as 
convenient for the user as is possible. I've 
written negative reviews with regard to 
editors that made the user take care of 
some situation that I thought the editor 
ought to handle automatically. For example, 
many screen editors require you to "extend" 
the buffer by telling them to insert 20 
blank lines, or by going to the end of the 
last line of the present text, putting the 
cursor at the right end, and typing a CR to 
get to the next line. Obviously if the 
editor software is smart enough to know 
that it is at the end of the fUe, it ought 
to be able to extend the file automatically. 

An editor shouldn't be filled with a 
bunch of what I call gingerbread features 
and then make it difficult for you to do 
something you do three or four times on a 
screen of text. For example, one of our 
text editors has limited "spread sheet" 
capabilities. It can total a line or a column 
of figures and insert that total for you 
automatically. While I am not knocking that 
capability, the same editor requires that 
you type several keystrokes to indent the 
start of a paragraph. If you edit that 
paragraph and reformat it, the initial indent 
evaporates and you have to put it back by 
repeating the same multiple key strokes. 

So aiyway, I started thinking about a 
screen editor last Winter. I did some little 
preliminary programming to see how hard it 
would be to do the cursor motions on a 




single screen of text. About then I got off 
on another project for several months, but 
about April, I decided to start in earnest 
on the project. As each feature was 
implemented, I tested what I had by using it 
to edit text. Of course that was difficult 
until I had enough going so I could write to 
a file and save my edited text, but I was 
soon at that point. Some of the early code 
proved to be messy, and it was refined as I 
continued to add more features. About the 
time most of the editor was working, I 
started looking for the places where most 
of the time was spent, and replaced some of 
the longest and slowest loops with assembler 
code, which is quite easy to do in PL/9, the 
language I had chosen for the project. 

Well, here we are some H months 
later. I won't say this was an easy project. 
There were times when bills didn't get paid 
on time, the lawn mowing was neglected, and 
nights when I had 1 or 5 hours sleep. (Why 
stop debugging at 1 AM when things are 
going well, right?) So, I've put my "efforts" 
where my mouth is. PAT is to be sold at a 
special introductory price. While I did it 
mainly as a challenge, I won't be unhappy to 
see a little return for my 400 or so hours 
that are invested in this project. 

Should you purchase PAT, I would 
appreciate hearing from you. I am not 
planning to add many more features to it, 
since doing so would begin to limit the size 
of the edit buffer more than I would like. I 
do plan to review the code critically and 
try to simplify it and reduce the size of 
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the ooject code. I want to know about any 
bugs that are discovered as soon as they 
are found. I will respond irarn lately to any 
bug reports, either with a quick patch or 
an update. While I have used PAT in its 
present form for some time, I won't pretend 
that I don't expect a few more bugs to 
surface. I try to test software that I have 
written for both normal and unexpected 
conditions, but I certainly haven't thought 
of them all. 

Editor's Mote: PAT and JUST (the 
processor) make an excellent combination. 
However, there will be many of you who will 
ask - "Why another editor or processor?" 
Well, the answer is simple, from my 
viewpoint, price, source included and upward 
compatibility with the presently available 
and coming 68XXX systems. 

To me the inclusion of source, 
presently in PL9, easily converted to 
Whimiscal, Pascal and C (a C version may be 
included soon) and other HLLs, make this an 
attractive product for many of our 
reader/use s. Not since the early days of 
TSC products has source been included. This 
means that you only have to purchase the 
product one time, that is if you are 
programming in a high level language (HLL). 
If not, you sure can learn a lot studying 
source, most of us did! 

This means saving in hundreds of 
dolla s. PLEASE remember, Ron and I (S.E. 
Media, distribution licensee) trust you not 
to abuse the copyright of the source and 
code. Also, we have intentionally priced it 
low enough to TRUST that if you want a 
copy you will purchase it rather than 
"borrow or steal" it. Ron has a lot of 
"sweat hours" involved and I assured him 
that you we e a very honest bunch. Thanks 
for rat letting me down. 

DHW 



INTRODUCTION 

Editor? Why on Earth.... Aren't there 
enough Editors around now? Those are all 
valid questions, particularly in these days 
of limited markets for software for FLEX 
and the 6809. First of all, if another 
editor that I have been using for several 
years now had ever become available for the 
FLEX 6809 group, this effort would probably 
never have been started. I am referring to 
PIE, the very nice editor written by Tom 
Crosley of SoftWest, that all the Apple 
owne s have had available for a long time. I 
was given a "pre release" copy of PIE with 
a Xerox copy of a hand marked manual for 
PIE on the Apple several years ago. I've 
always said that if it ever became available 
I would have to buy a couple of copies to 
reflect my liking for it and my use of it. 
Due to circumstances, however, PIE for FLEX 
is not to be. 

Hy disappointment in the situation, 
increased by rumors and promises of 
"someday" led me to start writing something 
more or less equivalent to it. I have used 



some number greater than ten editors on a 
number of different computers, and PIE had 
struck me as being better as a general all 
round tool than any of the others. There 
are TEXT editors and there are PROGRAM 
editors a d one would think them to be so 
different and special that no one could 
write one that would serve both purposes. 
That is a lot of nonsense. There is no 
reason that one editor can't serve both 
purposes. One of my primary design goals 
has been to keep it simple and avoid frills 
that only a few users would use now and 
then. I have concentrated on making the 
most often used functions as simple to use 
as possible. 

The main goal in the design of PAT 
was not lust to copy an editor that I like 
very well, but to try to incorporate some 
improvements as I went along. L.et me 
outline what I believe to be the best 
features of PAT. 

1. Clean Screen Layout - Pat puts 
nothing on the terminal screen but one 
status line at the very bottom. If the 
terminal supports reverse video the line is 
displayed in that mode. If not. the line is 
displayed normally. The status line has line 
and column indicators and mode indicators as 
well as a display of remaining memory in 
the edit buffer. This same status line is 
used whenever user input must be done in 
the course of editing a file. 

2. Minimum Keystrokes - PAT is a 
SCREEN editor, not a line editor. The main 
tool of a screen editor is the cursor, and 
the cursor is used to advantage by all good 
screen editors to mark start and end of 
blocks of text that are going to be copied, 
moved or deleted, and for many other 
functions. In short, if it can be done with 
the cursor, you won't be asked to type in 
information. 

3. Speed - PAT will allow you to type 
successive commands that move the screen 
around in the text, and it will abort 
rewriting the screen to do another command. 
For example, in many screen editors, if you 
bump the top of the text window with 
CURbOR UP motions, the screen will move up 
one line in the text (or the text will move 
down in the screen). Some editors will 
rewrite the screen completely three times 
if you bump the top of the screen three 
times in a row. PAT will interrupt the 
screen refresh essentially as soon as it 
starts in order to handle another command. 
When the commands stop coming, the screen 
will be rewritten. 

H. Ease of maintenance - This is a 
feature for the author, but it means that 
errors or bugs that are found by users can 
be fixed quickly. PAT in the original 
release is written in the PL/9 language. My 
intention was and is to write it eventually 
in "C". However, I know of no "C" compiler 
that will compile code in less than 5 or 6 
times the time required to compile the 
equivalent program in PL/9. I had little 
choice but to do it in PL/9 first and plan 
on a translation later. After finishing the 
coding in PL/9 and some preliminary 
debugging, I rewrote some sub procedures in 
Assembler. As of now. just at 2,2% of the 
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final ohject code represents Assembler 
code. This small part of the software 
accounts for most of the tii.ie taken to do 
the various functions, and the optimization 
represented by that small amount of 
assembler code is responsible for a speed 
increase of about 5 times. The 
representation of the procedures in a high 
level language makes the program listing 
much more understandable to others, as well 
as to the author after the passage of some 
time. As a matter of interest, The code is 
approximately 2300 lines, about 150 of which 
are assembler code. The source listing is U4 
pages, and the object code is 15.9K. 

5. Big Buffer - The main edit buffer 
is 29.000 bytes. This means that you can 
edit over 7 paces of single spaced 
typewritten material within the Duffer. Files 
larger than that can be edited by writing a 
portion of the buffer to the output file 
and reading more from the input file until 
the whole file has been processed. 

6. Good File Handling - The input file 
is never renamed until the output file has 
been written. At that point the input file 
is renamed .BAK, the old backup is deleted 
(if it exists) and the new file is renamed 
from .SCR to the extension of the input 
fiie. Power failures never result in 
confusion since the input file was not 
renamed .BAK at the start of the edit 
session. You may delete the .BAK file 
before starting an edit session, but you 
must choose to do so. If you do not, there 
will be a time when three copies of your 
file are present on the disk at the same 
time (though briefly). In addition to the 
normal file functions, PAT allows reading a 
"side file" into the file being edited (at 
the cursor position of course). It also 
allows writing a previously marked block of 
data to a file. A late addition is the 
ability to access FLEX utilities while 
running PAT. These must be used with 
caution, however. See the expanded 
instructions later in this manual. 

7. Easy Setup - Want to set tab stops 
every three columns? Just type ESC 3 "T. 
Tab positions will be set a d displayed on 
the vop line of the screen. When you are 
sure that is what you want, hit a key and 
you are back to normal editing. If you want 
to set the tabs to specific and unevenly 
spaced columns, you type ESC t and bump 
the cursor along the top line with the 
space bar until you find the column you 
want to be a tab stop, then type any other 
key. Continue across the screen until all 
tabs are set a d hit RETURN. 

8. Reasonable operating modes - In the 
normal OVERLAY mode, the terminal screen is 
analogous to a piece of paper in a 
typewriter. You don't have to alter CR'S to 
get down three lines below the current end 
of the text, just bump the cursor down 
there and type. If you want to type 
something in the middle of a blank screen 
just go ahead. PAT takes care of blank lines 
and spaces out to the text. 

In "INSERT" mode characters are 
inserted at the cursor and the text to the 
right is pushed along until it hits the line 
length limit. Both of these modes are 
operative along with either of the two 
modes that follow. 
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PMODE - (Paragraph MODE) - is used 
primarily for text. lh this mode you never 
have to think about a CK. Text fills a line 
and when a word overflows that line it is 
moved to the start of the next line, even if 
you are inserting t»;xt in the ruddle of a 
paragraph. This mode is close to the one 
referred to as "Document Mode" in Wordstar 
terminology. 

ANODE - (Auto indent MODE) - In this 
mode, when the cursor Moves to a new line, 
it aligns itself with the first printable 
character on the line above it. This mode is 
extremely useful for programming and 
typing outlines. There are tab and backtab 
keys that also aid in this mode. 

9. Normal Text File - Some editors 
generate a "peculiar" text file containing 
"Soft Carriage Returns", "Hard Spaces" etc. 
Some use no carriage returns within a 

? anagraph so that each paragraph is one very 
ong line. Though such editors generally 
work fine within their own "system", the 
files that they produce are hard to LIST to 
the terminal or edit with other editors. 
PAT produces "standard" text files. In FLEX 
that means that each line as you see it on 
the screen while you edit, will be saved 
with the standard (CR) line terminator. The 
FLEX LEST utility and others assume this to 
be the form of the input file, and 
therefore all the FLEX utilities work with 
PAT files with o special handling. 

10. Paragraph Formatting - Features 
are available to format paragraphs to the 
currently set margins. One of the 
configuration parameters that you may 
include in your terminal configuration file 
is the paragraph indent desired in 
formatting paragraphs. A paragraph may be 
formatted with or without justification. If 
justification is on, spaces will be added to 
each line to make the right margin even. 
Regardless of the status of Justify, words 
will be rearranged within the paragraph to 
fit the liiaxii.ium number that will fit on 
each line, and the first line will be 
indented. Generally after formatting a 
paragraph the cursor will be found on the 
first character of the next paragraph so 
the process can be repeated. The format 
operation is done a paragraph at a time so 
you can view the text and skip formatting 
of tables etc. 

A paragraph that has been formatted 
with justification may be reformatted 
without it, and all the added spaces will be 
removed. Formatting a paragraph will 
automatically put two spaces after a period 
that is followed by one or more spaces. 
Only one of those spaces will te "padable". 
That is, the justification routine won't add 
a space to both of the spaces after a line 
making the spacing very much wider than 
the other spaces. 

11. Long Lines - PAT allows lines as 
long as 127 characters. The screen will 
automatically shift as you t.iove off the end 
in the direction of the remainder of the 
text. All functions of PAT work with the 
screen shift. 

There is one more feature that should 
be mentioned in the introduction. Did you 
ever assemble or compile a program and get 
a message such as ERROR 0202 in line #237? 



November '85 






Some editors do not associate a number with 
each line. Though PAT doesn't display 
numbers, on every line, the line indicator on 
the status line does display the current 
cursor line number. Each line is associated 
with a file line number. In the case of the 
above error message, y^ou load the file into 
PAT and type ESC 237 G and before you can 
blink that line is about 1/3 of the way 
from the top of the screen and the cursor 
is at the beginning of it. 

It should also be made clear what PAT 
is NOT. PAT Is not a full text formatter. 
There is no provision for paging or header 
and footer formatting of pages. It is 
assumed that the user will embed word 
processing commands in the text arid run the 
output through one of the several text 
processors that are available. The 
formatting that is available, of course is 
only useful if the printer to be used is of 
the non proportional spacing type. For use 
with a text formatter set up for 
proportional spacing, use only the Format 
mode without justify, Commands to be 
interpreted by trie text formatter as start 
of paragraph may be used in the text. For 
purposes of formatting a paragraph, the 
paragraph ends if the first character of the 
next line is a CR (i.e. a blank line), if it is 
one of the symbols usually used to indicate 
a formatter command (comma, period, or 
colon), or if it is a space (leading space on 
a new line). This last is included so the 
user nay format paragraphs without blank 
lines between them, starting a new paragraph 
with one or more spaces. 

This effort to date represents some 
400 hours of programming. I would hope that 
purchasers would respect the copyright and 
urge their friends to purchase their own 
copy. 



DESCRIPTION OF KEY FUNCTIONS 

General Notes 

In the following descriptions the up 
arrow indicates that the Qpntrol key 
(marked CTRL or possibly on some 

terminals) should be held down while the key 
is operated. For example ~E means to hold 
the control key and the E key down at the 
same time. On most terminals it does not 
matter whether you use capital E or lower 
case e. 

Control keys that change the contents 
of the screen or window will cause the 
window to be completely or partially 
rewritten as necessary to get the correct 
information in the window. Note that if you 
repeat a key that changes the information 
in the window, the screen rewrite Aborts 
instantly. That is, if vou have text above 
the window, and type t five times rapidly, 
the screen will move up 5 lines arid then It 
will be rewritten. This is a very significant 
feature of PAT. It saves a great deal of 
time for the user. 

Some of the commands later use the 
ESC (escape) key as a prefix, for example, 
ESC 5"I means that you type the ESC key, 
the number 5 and then "l, (this inserts 5 



blank lines above the cursor). Generally the 
ESC key puts the cursor on the status line 
at the bottom of the screen and you type 
characters there, terminating the input with 
a control character or Carriage Return. 

CURSOR CONTROL 

~E - Cursor Up 

This key moves the cursor up one 
line. It does what it has to do to 
accomplish this. If the cursor has room on 
the screen, It simply moves up one line. If 
it is at the top of the screen, it "pushes" 
the screen up in the text so that the next 
line is visible. If the cursor is at the top 
of the file, it does nothing in response to 
this command. 

"C - Cursor Down 

This key moves the cursor down one 
line. It behaves like the cursor up key with 
a few exceptions. Ii' the last line of the 
file is at the bottom of the screen and the 
cursor is moved down past the end of the 
screen, the text moves up 15 lines (for a 24 
line monitor) placing blank lines below the 
text. Moving the cursor down below this 
screen will move the text up and insert 
more blank lines. It is not pos ble to move 
the cursor so far down that the screen goes 
blank. The last line of the text will remain. 
If you must skip more than a screenful of 
blank lines, temporarily put something on 
one of them, add your text below the break 
awl delete the tenporary characters. 

*S - Cursor Left 

This key moves the cursor one space 
to the left without changing the text in 
any way. The cursor can not be moved past 
the left margin with this key. 

* F - cursor Right 

This key moves the cursor to the 
right. Presently PAT does not have 
horizontal scrolling, and the cursor cannot 
be moved past the last column on the 
screen. 

"D - Cursor Home / Bottom 

This key moves the cursor to the 
upper left corner of the text window if it 
is not already there. If it is there, it 
moves to the lower left corner of the 
window. The text in the window does not 
move. This key is handy for getting to the 
top or bottom of the screen in a hurry 

**] - Cursor Begin / End 

This key moves the cursor to the end 
of a line if it is within the text, and to 
the beginning if it is at or past the end of 
the text on the line. On some terminals the 
right bracket {]) is represented as the 
upper case of the left bracket. In this case, 
you will probably have to use CTRL SHIFT 
along with the "bracket key" to get this 
function to work. 

"G - Right Tab 

This key moves the cursor to the 
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next tab position right. Tab positions are 
defined either by the text already on the 
line or by the tab settings (see ESC n T 
below). If the editor is in the PMODE, tabs 
within the text move the cursor to the 
first character of the next word to the 
right. If you tab past the end of the text, 
tabs revert to the selected tab columns. In 
AMODE, tabs always move to the marked tab 
columns. This is really the best of both 
worlds. If you are in a paragraph,^ you can 
tab three words right by typing *G three 
times. It becomes almost autonatic. Now go 
to a blank line and tab to the set columns 
for entering a table. Tab Right will not tab 
past the end of the screen. 

"A - Tab Lea 

This key tabs left to the first 
character of the previous word when the 
cursor is within text and the editor is in 
PMODE. When outside of the text, the cursor 
moves to the previous tab set position. See 
remarks about Tab Right above. Tab Left is 
very useful in the AMODE for programming 
or typing an outline. Tab Left will not tab 
past the beginning of a screen. 

SCREEN CONTROL - DESCRIPTION 

* K - Screen Up 

This key moves the screen up in the 
text by one line less than the number of 
lines that are displayed on the screen. That 
is, the first line on the screen becomes the 
last line after "R. The cursor stays exactly 
where it was before the R. This feature is 
useful both in program editing and text 
editing. You can go up two or three screens 
to refer to some previously entered text 
(or program) and go back down the same 
number of screens, and the cursor will be 
right at the spot where you were editing 
before you went away from that spot. 
Obviously you can't screen up beyond the 
start of the file. 

"V - Screen Down 

This key moves the window down in 
the text by one line leas than the number 
displayed in the window. That is, the bottom 
line before the "V becomes the top line. 



U 



Current Line Up 



This key moves the present cursor 
line (with the cursor) to the top of the 
screen, (actually it moves the window down 
in the text but psychologically, you are 
moving the cursor line to the top of the 
window, so it fits here on the top row that 
is associated with UP commands. This is 
useful for fitting as much of a particular 
paragraph or program procedure on the 
screen as possible. Put the cursor at the 
first line and move it to the top of the 
screen. 

"Y - Screen Up 1/3 

This key moves the screen up in the 
text by 1/3 screen. If the cursor was high 
on the screen it will remain with the line 
where it was before the move. Of course, if 
the cursor line before the move falls off 
the bottom of the screen, the cursor will 
stick at the bottom line. 



"N - Screen Down 1/3 

This Key moves the screen down by 
1/3 screen. The cursor sticks with the line 
if it stays on the screen. This is useful for 
proofreading the text. Read along arid follow 
your current line with the cursor. When you 
get to the bottom, do a couple of "N's and 
the cursor will be 2/3 of the way up the 
screen and at the line you have just read. 
Now continue reading and bumping the 
cursor. 

"T - Top of File 

This key moves the top of the file 
into the window, with the first line of the 
file at the first line of the window. 
Repeated use of this key will do nothing 
further. 

"b - To Bottom 

This key moves the bottom of the 
file to the line 1/3 of the way down the 
screen and puts the cursor on the next line 
below the^ present end of the file. 
Successive B will not change the situation. 

EDITING FUNCTION KEYS 

"H - Backspace 

This key has two different actions 
depending on whether you have the INSert 
mode on or off. When the Insert mode is off 
(Overtype Mode) the cursor moves back one 
space and replaces the character at that 
position with a space. In the INSert mode, 
the cursor moves back a space, deletes the 
character at that space, and brings the rest 
of the text to the right of the cursor 
back with it. If this sounds confusing, the 
Backspace key operation follows what the 
cursor does when entering text in the 
respective modes. The action Is quite what 
you would expect in these modes. 

NOTE: The backspace WILL backspace 
past the left margin and go to the end of 
the text on the previous line. You will 
appreciate this when you want to fix the 
last character you typed before a Carriage 
Return. You can back up through a line and 
into the next one above if you need to. 
Also note that it is not possible to leave a 
line with several spaces on it. PAT 
automatically 'cleans up' a line when the 
cursor leaves it. If there are spaces 
followed by a CR, PAT will remove all the 
spaces and the CR will be in the first 
Dosition on the line. When the cursor moves 
TO a blank line, PAT puts spaces out to the 
cursor so that if you type something there, 
it will be preceded by enouch spaces to put 
it there when it is printed. It is not 
possible to leave trailing spaces on a line 
with PAT. 

"I - Insert a Line 

A blank line will be inserted where 
the cursor presently is located, and the 
text on that Line will be moved down. The 
last line on the screen will move off to the 
bigger edit buffer. It is not lost. 

"K - Delete (Kill) a Line 

The line on which the cursor is 
located will oe deleted. Text below it will 
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move up to 1111 the space made by deleting 
the line. The last line of the display will 
be moved up from the big edit buffer. If 
you are at the bottom of the file, the last 
line will be a blank line. Insert and Kill 
may be repeated rapidly to insert or delete 
a number of lines. 

Note that ~K has another function. 
When a line is deleted, it is not lost, but 
goes to a Delete Buffer (only ONE line will 
fit in the delete buffer and it will always 
be the last one deleted). This fact may be 
used to advantage in two situations. First, 
if you accidentally delete the wrong line, 
or one too many lines, yo can "restore" the 
line with the command that follows this one 
below. Secondly, this is a QUICK method to 
move a line. You delete the line, put the 
cursor on the line below where you want to 
insert it and type "0. 

"0 - Output Delete Duffer 

This command will put the contents of 
the delete buffer at the line where the 
cursor is. The line that was there will move 
down to make room for the inserted line. 
This is just like the "I function except 
that the inserted line contains text. If you 
have not used "K to delete anything, you 
will get a blank line. 

"L - Push Line to Delete Buffer 

This command lets you copy a line. It 
puts the line in the Delete Buffer but it 
doesn't delete^lt. Now you can move the 
cursor and use "0 to duplicate the line. 

Note that the above are handy to 
handle a line or two. There are other ways 
to mark a large block of text, delete it, 
move it, or copy it. These are discussed 
later . 

ESC "S - Split a Line at Cursor 

Put the cursor on the first character 
you^want to move to the next line and type 
ESC*S. The character at the cursor and 
ever ything to the right will be put on a 
new line below the present one, and the 
text below will be moved down a line. The 
cursor remains at the Split point so you 
can continue to type there. This is handy 
for inserting more text on re-editing 
already written material. 

ESC "J - Join Lines 

Put the cursor anywhere on a line of 
text. "J will join the next line to the 
current one, changing the trailing CR to a 
space, IF THERE IS ENOUGH ROOM on the line. 
If not, you will get an error message. All 
error messages remain on the status line 
until you press any key, after which you 
can resume editing. If you want to join 
lines but they won't lit, you can split the 
second line at a point where what is left 
will tit... 

ESC nn A I - Insert Multiple Lines 

Rather than type "I 12 times, you can 
insert 12 blank lines by typing ESC (cursor 
will move to the status line Tollow^ng the 
prompt ARG: where you type in 12 I. The 
number of blank lines that you specify will 



be inserted. 

ESC nn~K - Delete (Kill) Multiple 
Lines 

Works like the above command except 
that it can delete multiple lines. As a 
precaution, the status line shows the prompt 
DELETE 12 LINES? (or whatever number you 
have specified). Answer with a Y, either 
upper or lower case, and the lines will be 
deleted. An N or other response will QUIT 
the function. If you delete more lines than 
are left in the file, all of the file below 
(and including) the cursor line, will be 
deleted, i.e. to the bottom of the file. 

FORMATTING COMMANDS 



PMODE) 



ESC nn"L - Set Line Length (for 



Use this to set the line length at 
which words typed in will wrap to the next 
line when in RHODE. The line length appears 
on the status line at the bottom or the 
screen, as L=65. 

ESC "P - PMODE On/Off 

This command toggles the PMODE on 
and off. The default mode is with neither 
PMODE nor A MODE on. In that default mode, 
you must use a CR to get to the next line. 
When PMODE is on, the word PMODE appears on 
the status line. 

ESC *A - A MODE On/Off 

When this command is used, AMODE is 
toggled on and off. If PMODE is on, it is 
turned off by AMODE and vice versa. The 
utility of AMODE is that when you type a 
CR, the cursor moves to the column under 
the first printable character in the line 
above. That is, it goes to the same indent 
level as the previous line. This is useful 
for programming or outlines. 

ESC nn"G - Goto Line nn 

When you use an assembler or a 
compiler, generally error messages include 
the file line number on which the error 
occurs. You can load the program source 
file and Goto the line in question. 

ESC n"T - Set Regular Tabs 

This command sets the tabs every N 
columns (including the first). It displays the 
tabs on the top line of the screen as the 
last digit of the column number if the 
column has no tab set, and as a vertical bar 
if a tab is set. If you want irregular tab 
columns, type ESC T and the tab line will 
be displayed at the top of the screen. The 
cursor will be at the first column of the 
second line and you can move it along with 
the space bar, typing any other character 
where you want a tab set. When you are 
done, type CR and the top line will rewrite 
to show your tab positions. When you have 
verified them type any key to return to 
editing. 

ESC "C - Toggle Caps Mode 

You may not need this command. If 
you do, you will be very glad for its 
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existence. Some terminals do not have a 
CAPS LOCK key so that all letters a to z 
are converted to upper case but the 
remainder of the keyboard remains the 
same. Caps Mode does that with software. If 
your terminal doesn't have a Caps Lock key 
or it has a (UGH) Shift Lock, you will use 
this function. 

ESC "Q - Toggle Justify Mode 

"Q - Format current paragrapn 

PAT has paragraph formatting 
capability via the ~Q command. If Justify 
mode is on, the letters JU appear on the 
status line. Put the cursor anywhere on the 
first line of a paragraph and type "Q and 
the paragraph will be formatted with full 
justification (that is, the left and right 
margins will be even. The first line will be 
indented by the PARINDENT constant which 
defaults to 5, but is configurable via the 
Terminal configure file. Spaces will be added 
within each line to make them all the same 
length. The line length will be one less than 
the current right margin setting. The cursor 
will generally be left at the first line of 
the next paragraph so that this command may 
be repeated. There is no GLOBAL format 
command because the program cannot always 
tell the start of a paragraph from 
something else such as a table, a heading, 
etc. The end of a paragraph is detected by 
any of the following: 

1. A line starting with a comma, period, or 
colon. These are used by most text 
formatting software to indicate a formatting 
command. 

2. A blank line (a CR in the first column) 

3. A line starting with a space. 

The second case should be obvious. If 
you end a paragraph with a C R, and then 
skip a line, the program has no trouble 
detecting the end of the paragraph. The 
third case is for those who don't want blank 
lines between paragraphs. When you type the 
text, simply indent one space at the start 
of a new paragraph. See the caution below 
regarding this method of delimiting 
paragraphs. 

If the Justify mode is off when you 
issue the Format command, the words will be 
moved around, lines split and rejoined, so 
that all the lines contain all the words 
that will fit within the presently set 
margins. The only difference from the case 
of Justify mode being on is that no spaces 
will be inserted between words. Regardless 
of mode. Format command will out two 
spaces after any period that is followed by 
a space (primarily for ends of sentences). If 
a paragraph has been formatted with Justify 
on, formatting it with Justify off will 
remove all the extra spaces that were added 
to make the lines come out even. Some users 
of PAT, particularly if they have a text 
formatter program that works with a 
printer that has proportional letter spacing, 
will want to have the formatter do the 
Justification. However, the capability to 
maximize words on each line will be 
appreciated after re-editinG a section of 
text. 



If you have one of the many printers 
that provide only constant pitch printing 
(10 per inch or 12 per inch), you may use 
PAT to pre-format paragraphs so ^ou can get 



an idea of how long the text will be. Note, 
however, that PAT has no provision for page 
headers, footers, or page numbers. Such 



functions will have to be nandled by a text 
formatter. 

SEARCH AND REPLACE 

Search and replace functions are easy 
to use. First you enter the search string. 
As soon as it is terminated, the search 
begins, and if the string is found in the 
text, it will be on the screen with the 
cursor at the first character. Then the 
Replace string is entered. When it is 
terminated, the string will be replaced. If 
you decide that the "found" string is not 
the one to be replaced, you can repeat the 
search and look for the next occurrence of 
it. There is also a "GLOBAL" replace mode 
in which all occurrences from the cursor to 
the end of the file are replaced. 

ESC TEXT' 2 - Enter Search String 

Type ESC and the cursor goes to the 
status line. Now type the text string you 
want to find. Spaces may be included in the 
text string for the search. This is useful 
when searching for such things as ESCCASE 1 
Z. Space after the 1 distinguishes this case 
so that it doesn't "find" CASE 11 CASE 12 
CASE 123 etc. The control Z terminates the 
search string and causes the search to 
start. Search is case sensitive. A search for 
"school" will not find "School". (A case 
insensitive search mode may be added in a 
later release). 

EXC TEXT'X - Enters Replace String 

This string is entered in the same 
way as the search string. The cursor should 
be at the found occurrence of the search 
string since it will be replaced after you 
enter this string. Note that the replace 
string is terminated with ~X. 

" 2 - Repeat the Search 

A search string must be defined or 
you will get an error message "Nothing to 
search for". With this command, you can 
search through a text or program for all 
the places where the string occurs and 
decide at each one what you want to do 
with it. NOTE: Searches all proceed DOWN 
from the current cursor position. If vou 
want to look at all occurrences of a 

Particular string, be sure you start at the 
OP of the file. 

"X - Repeat Replace 

This command will use the previously 
defined replace string. The cursor must not 
be moved from the place where it was after 
completion of a SUCCESSFUL search for the 
search string. If you type this command and 
these conditions are fulfilled, the current 
occurrence of the search string will be 
replaced with the current Replace String. 

"W - Global Replace 

After finding and replacing the first 
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occurrence of a string, and without moving 
the cursor, type ~W and all occurrences 
from the cursor position to the bottom of 
the file will be found and replaced. The 
current line indicator on the screen will 
update as each occurrence is found. Ypu can 
stop the global replace by typing ~C. If 
you let it go to completion, the screen will 
update with the last replacement on the 
screen and narked by the cursor. 

BLOCK FUNCTIONS 

Ulocks are important in most editors. 
You "mark" a block of text, arid then you 
can do one of several things. PAT will let 
you DELETE a marked block, COPY it to 
somewhere else in the text, (and leave it 
where it was), MOVE it to somewhere else 
(removing it from its original position) 
WRITE it to a file, or UNMARK it if you 
change your mind. You can also READ a 
BLOCK from a file into your text at a 
selected place. All of the block functions 
are terminated by a CR. Blocks are defined 
as one or more whole lines. 

ESC T<CR> - Mark Top of file 

Place the cursor on the first line 
that is to be included in the block and type 
tSC T<CR>. The number of that line will 
appear on the status line (displacing the 
MEM NNKIU! temporarily) as TsNHN. 

ESC B<CR> - Mark Bottom of file 

Put the cursor at the last line in 
the block and type ESC B<CR>. The reminder 
B=NNN will appear after the T=NWN on the 
status line. These prompts will remain there 
as long as the block is marked. 

ESC D<CR> - Delete Marked Hlock 

The position of the cursor is 
unimportant when you issue this command. 
The marked block is deleted. It disappears 
from the text that is being edited aria the 
screen is rewritten without it. Of course, 
since the block disappears, it becomes 
unmarked and the MEM NNNNN status 
reappears. 

EXC H<CR> - Hove Harked Block 

Place the cursor at the line where 
you want the block to be inserted (it will 
be inserted above the line where the cursor 
is placed. Again, since the block disappears 
from its original location, it will be 
unmarked. 

ESC C<CiO - Copy Harked Block 

Place the cursor at the line where 
you want a copy of the marked block. It 
wi]l be inserted above the cursor line, and 
also remain in its original location. Since 
the original block is still there, it will 
remain marked and you can copy it again any 
number of times. When you are done copying, 
just use the command described next, to 
urwiark the block. 

ESC U<CR> - Unmark Block 

This command does just what you 
would think. If you make a mistake in 
marking a block or have copied it and want 



to unmark the original, this is the command 
to use. When the block is unmarked, the HEM 
NNNNN display returns to the status line. 



File 



ESC >FILEWAME<CR> - Write Block to 



The arrow pointing at the filename is 
the key for this command. It opens a file 
named FILENAME (default extension .TXT and 
default drive, working drive). Then it copies 
the marked block to that file and closes it. 
Since the block is not deleted from the file 
being edited, it is left marked. After 
copying it to a file you can unmark it or 
delete it. 



File 



ESC<FILEUAME<CR> - Read Block From 



The arrow pointing FROM the filename 
indicates that the file is to be read IN to 
the text being edited, AT the cursor (again 
above the current cursor line). The same 
defaults apply as above. 

EXIT FUNCTIONS 



ESC 



- Exit and save backup file 



This is the normal exit function. It 
does just what is described earlier in this 
manual under the heading FILES. That is, it 
deletes an OLD backup file if one is 
present, Renames the input file (if any) to 
.12AK and writes and closes an output file 
with the extension .SCR. It then renames the 
«SCR file to the extension of the input file 
or to that specified for the output file. 
Note that this command is £SC CTRL 
up-arrow. The up-arrow on some terminals is 
typed by using SHIFT 6. If the up-arrow is 
a ''capital 6" on your terminal, you may or 
may not have to operate the SHIFT key in 
addition to the CTRL key to get a control 
up-arrow. Some terminals shift automatically 
since "6 is not a valid ASCII code. Others 
do not. 



EXC Q' 



- Quit edit 



This mode simply abandons the current 
edit. It will always leave the input file and 
backup file as they were before you started 
the edit. If the file is too big to fit in 
the edit buffer, part of it may have been 
written to a .SCR file. Using this command in 
that case will leave a partial output file 
with the extension J3CR. If you have done a 
lot of work on the early part of the file 
and then fouled up a later part, the partial 
output file may be of some value. Generally 
it is better if you have already written to 
an output file, to use the normal exit mode. 



BJ(i FILES 



ESC N" 



- New text 



This command requires that the 
cursor be positioned with some thought. It 
causes all of the file above the cursor to 
be written to an output file and if the 
input file is not empty, more of it is read 
into memory. If the remainder of the file 
will fit in the 26000 character limit, it is 
all read in. If not, the New command may be 
repeated later after writing more text to 
the output file. This is a way to edit very 
large files, though in general it is better 
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to split files into "chapters" or "libraries" 
so that each file will fit the edit buffer. 
Most text formatters allow you to specify a 
starting page number, and you can print your 
files out in sequence, each time specifying 
the next page number as the first for the 
next file. 

FLEX UTILITIES 

ESC +FLEX COMMAND<CR> 

FLEX commands can be executed while 
editing files. Of course you must not use a 
utility that uses memory outside of the 
utility command space, such as NEwDISK 
(FORMAT) or COPY. There are certain other 
utilities that will cause problems as well. 
Because of the way files are handled by 
PAT, the output file is opened at the start 
of the edit session. The Standard TSC LIST 
utility closes the file that it has listed by 
calling the FLEX FLSCLS routine which 
closes ALL files including the output file 
for the text you are editing. You will be 
able to list another file just fine, but when 
you try to save the current file you will 
get a SYSTEM FILE ERROR, which is a cryptic 
way of saying that the file has already 
been closed. A LIST1 utility has been 
supplied with PAT that closes the listed 
file in the normal manner in all cases so 
that it will not close your output file. 

Should you accidentally use the 
original LKT utility supplied with FLEX, and 
get an error message while using it, all is 
not lost. Do NOT try to write the output 
file with a normal exit. Mark the first and 
last lines of the file (make the whole file 
the marked block) and write a sideflle with 
a name different from your intended output 
file. If you forget and try to exit 
normally, and get the SYSTEM FILE EHROR 
message, you can still mark the file and 
write a side file, but you will get one 
screenful of your file repeated in the side 
file. You can then re-edit the file and 
delete the redundant screen of text. Test 
any utility you might think you will use 
wldle running PAT, by using it while editing 
a non-critical file to see if it causes any 
problems with the output file, or if it 
overwrites any of PAT or the edit buffer. 

The main reason for including this 
features is to allow you to use a CAT, DIR, 
FILES utility to get a list of files on the 
disk in case you want to read from a 
sidefile but have forgotten its name. Use 
any other FLEX utility with extreme 
caution. 



EDITOR'S NOTE 



WRAP-UP 



FROM DON WILLIAMS 



Well, there you have it. A good look 
at PAT, an editor for all occasions. This 
item will soon Join the hundreds of other 
FINE products from South East MEDIA. We 
are in final "Beta" testing now. When it is 
ready for sale (soon - we hope) it will be 
included in the South East MEDIA catalog, in 
68 Micro Journal. Also, there will be a 
limited time special for the JUST text 
processor and PAT combined. This will be an 
excellent combination package for those of 
you not willing to part with an arn and a 



lea for another editor/processor. And the 
really sweet part is, THE SOURCE IS 
INCLUDED!! 

The JUST package will have one binary 
object JUST and three (3). Yep, three (3) 
different source files of JUST. Fact is the 
JUST package with all three (3) is now being 
sliipped, IT IS READY! And comprises the 
following: 

1. JUST in PL9 source (s me as the object 
file included). 

2. JUSTSC in C source - THIS ONE CAN BE 
COMPILED OH 0S9! Also it can be compiled 
under FLEX, naturally. JUSTSC is a slightly 
different format, includes several additional 
printer commands and format features. It is 
so structured to accept many TSC style 
text files (using commands, i.e. - up sp ce, 
etc) This is a real winner if you nave text 
files in the TSC format, or are used to 
them. Of course being in C, you can change 
practically anything to anything else you 
might desire. And It is patently simple to 
add practically any other useful command or 
feature you might desire. This is true for 
both the PL9 and C source files included, at 
no additional charge! 

And finally there is the same JUST as 
in the PL9 version, only in C source. Again. 
simple to modify to your hearts (#na 
pocketbooks) delight. 

Everyone who has purchased JUST and 
commented to me later about it, RAVE! 

So, if you do not have PL9 or C, 
never mind, the JUST included on the disk 
runs under FLEX. 3ut you 0S9 folks will 
have to compile it for now. However, I will 
furnish a FREE copy, or refund the purchase 
price to the first one who compiles JUST, 
using our C source, into an executable 0S9 
module. Naturally, it should run "bug free"! 

Also we have an "update policy" fbr 
those of you with older versions of JUST, 
Return your original disk to South East 
MEDIA along with the sum of $19.50 + $2.50 
H/S, and we will update to the latest 
everything, Including the new source files, 
and instructions. 

I am doing all I can to bring you, 
though South East MEDIA, good and especially 
low priced software, But I need your 
cooperation. If you know of some product, 
that you desire, that is not in our catalog 
or stock, please let me know. Remember 
this, it is South East MEDIA and DATA-COMP 
that helps support 68 MICRO JOURNAL. It is 
your magazine - so I leave it all to you. 
Between the two, South East MEDIA or 
DATA-COUP, practically anything you ever 
heard of for the S50 bus or the 68XX(X) is 
available, and most of it from stock. And 
now with our new service department, I have 
done about all I can do. If we are to 
continue, we need your support. WE SUPPORT 
WHAT WE SELL - AND EVEN IF THE 
MANUFACTURER GOES "BELLY-UP", WE WILL 
STILL BE THERE! Today, that is a very 
valuable consideration. So remember the next 
time you get ready to buy - give them a 
call. It just might be the smartest and 
safest thing you could dot 
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I can snswer the question sbout debugging device 
drivers quickly. Unless you hsve hardware debugging 
tools It Is nssty work. Mlcrowsre used to hsve 
something cslled (1 think) sn over-the-top debugger. It 
was able to do some primitive debugging from outside the 
OS-9 environment. Prom whst 1 hesr, now thst Mlcrowsre 
has In-clrcult emulators they don't maintain the 
over-the-top debugger anymore. Lt has been reported 
deud. 

1 hsve two tricks 1 use when debugging OS-9 system 
code. Both give limited Information and neither ts 
Interactive. 

If the problem Is small I try to get enough 

Information by aettlng bad return codes. If 1 chink the 

trouble is with a psrtlculsr one-byte value, I Load lt 

Into register B, set carry, and return. The value makes 

Its wsy bsck to the calling program ss s bsd return 
code, with Lots of time and pstlence I csn get s pretty 
good picture uf what's going on this wsy. 



Wlien the pro 
one-byte peephole L 
big dsts module 
module link to It 
Interesting fscts t 
l save s character 
the registers , snd 
module exhibit!) Lcs 
system crash) I can 
or write It to h II 
technique collect* 
easy to Install sdd 
code. 



blem Is too big 
use s trsce module 

(ssy 1024 bytes), 
and use lt ss 

n. For example, at 

string Locatlon-lde 

a few Important war 
bug (provided Lt 
link to the module 

to ,tntl |irliu It 
totH of data, but 

ttlonal bugs slong 



to see through s 

1 build s nice 

1 hsve the buggy 

a queue to save 

various key spots 
ntlfler, s dump of 
lsbles. After the 

doesn't cause a 

with the debugger 
villi dump. Tills 
It's distressingly 
with the debugging 



I can give a more sstlsfsctory snswer sbout the 
tssk register. OS-9 uses it. The first clue Is In esch 
process descriptor. There Is s vslue there called the 
taek number. This 1* the vslue thst OS-9 stores Into 
the task register when lt Is ready to run that process. 
In the process status byte you will see s byte thst 
Lndlcstss whether the DAT Image In the process 
descriptor hss been chsnged since lt was Last used. If 
It wasn't chsnged OS-9 csn set the DAT by simply storing 
the tssk number In the UAT's tssk register. If the 
process's DAT Image la chsnged, OS-9 will have to updste 
the DAT with the new imsge. 

The use ot Lhe DAT tssk register makes things 
simpler snd faster. OS-9 only hss to write one byte to 
chsnge the entire DAT Image. When OS-9 is loading a new 



DAT imsge Into the DAT Lt sets the tssk register to the 
system task number (sll the dsts It needs Is tn the 
system sddress space) and gets s byte of the OAT Image; 
then Lt sets the task register to the value for the new 
Image It's building snd stores the byte Into the DAT. 
This would be harder If whole address spaces couldn't be 
swapped around by changing a single byte. 
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The AT&T Unli PC 

I've tried the AT&T Unix PC. In many ways lt Is s 
tine machine. It's quite fsst, has virtual memory, nice 
graphics, satisfactory window support, snd It's backed 
by a company with an excellent reputation. lt Isn't 
perfect by s long stretch, but two problems bothered me 

particularly. It doean't run OS-9 (and Lt should 

beautifully), snd there hss been s lot of tslk sbout 
AT&T's "open srchl lecture" policy (I.e., mostly closed). 

The two problems are connected. Mlcrowsre would 
very much Like to port OS-9 to the Unix PC. They are 
actively pursuing Lt with paople st AT&T. The problem 
Is thst they can't get some Important technical details 
frum AT&T. This Is the "open srthl lecture" problem. Lt 
they do get OS-9 ported (and 1 expect thst they will), 
there will be some question of who gets to market lt, 
Mlcrowsre or AT&T. Me, I'm sn optimist, I'll predict 
OS-9 for the AT&T Unix PC by first qusrter B6. 

I hsve heard s grest deal about how sticky AT&T Is 
being sbout hsndlng out Information about the workings 
of their machine. 1 was ready to lay Into them about 
that, but decided that I should put on my journsllst's 
hst snd ssk some questions. I got In touch with AT&T's 
public relstlons de|isrtment and they arrsnged a deluge 
of Information for me. 

I talked with Bob Se I linger from AT&T Information 
Systems. He gave me aome medium encouraging answers to 
my questions. 

Evidently AT&T Is trying to keep control of 
development for the Unix PC. The have s number of 
levels of support. Bob Selllnger ssys thst the manuals 
thst will sell to snyone who wsnts them should be 
sufficient for s qualified person to do sny kind of 
development for the AT&T Unix PC up to snd Including 
porting s new operstlng system to lt. If AT&T likes 
whst you are up to they can give much better support. 
They hsve already Invested Large efforts In other 
companies working to enhsnee the Unix PC. 

An exsmple of Information thst Is only available to 
compsnles that AT&T an! lea on are the acheo.it lea for the 
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aachlne. 1 think they are being Coo restrictive, 
think they are looking out lor their Interests. 



They 



The first lapreaalon 1 had of the "sailed on by 
AT&T" state wia that you had to be a aajor custoaer of 
theirs before you could begin to qualify. Bob Sclllnger 
says thst is not necessarily true. If they like your 
Ides enough they alght even back a aaall outfit. 

In particular, there la a path Hlcroware alght be 
able to go down to g«t the lnforaatlon they need to get 
US-9 running there. They ultould get In toueh with the 
Unix PC product aanageaent people. 

One general note on the AT&T PC. Don't even think 
of running Unix on It unless you have st least s 
aegabyte ol aeaory (you csn buy It with 5I2K but DON'T). 

Benchmark a 

The Glut* Hlcro-20 board lan't available yet (early 
August), but I got Hike Kagnus at Glmtx to run aorae 
henchriarka tur at? on their prototype. 1 sent hlra four 
urograms: 4 knight's tour, s flblnaccll nuabers prograa, 
a quicksort, and a prime nuaber aelve. Here are the 
timings For the (Unix Hlcro-20, a 68008, ay 6809, and a 
b MHz BUHb. The Hlcro-20, 68008 aachlne, and ay 
coaputer were running OS-9 and using Hlcroware C. The 
8086 was running KS-U0S and Microsoft C. 
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The Glalx Hlcro-20 will Include a 16-dsts-blt 
connector fur additional 1/0. It will be the connection 
point lor an optional graphics board that Clalx plana 
tor Che future. The graphics board will uae the new 
Hitachi graphlca chip which la already supported by 
Hlcroware. 

tUcroware'a Fortran coapller for the 6809 Is out to 
teat sites snd looking good. 

1 Just got 0S-9/68K version 1.2. It han at leaat 
three lrapurtant new Features: envlronaent varlablea, 
naaed pipes, and "events." 

The ahell can aet envlronaent variables which are 
local to It. Theae variables are psssed to esch prograa 
the ahell starts aa part of the paraaeter string (after 
the <CK> closing the coaaand line). Sheila inherit 
their parent's envlronaent, but don't pass anything back 
when they teralnate. The aaaple uae for envlrunaent 
variables that appeala to ae aoat la aa a good place to 
keep your teralnal type. 

Conventional plpea can only Bake connectlona 
between proceaaea and their children, or between sibling 
processes (If the pipes sre built by the parent). Naaed 
plpea can be opened on one end Juat like any aequentlal 
file. Any process that knowa the naae ot the pipe can 
open It. For exaaple, laaglne you have a proceaa 
controlling a aachlne which only needa instructions 
occasionally. You could leave a teralnal attached to 
the proceaa, but that would be wasteful It you had 
anything elae to do with the teralnal. You could have 
the process read a coaaand file i roe tlae to tlae, but 
that requires a dlak and Involves contention probleaa. 
You could use a dsts aodule snd a locking protocol; thst 
would work fine, but It's a little complicated. Now you 
can have the proceaa leave a naaed pipe open. You can 
uae the teralnal for whatever you want. When you have 
Instructions for the process controlling the aachlne you 
Just pour thea down the pipe. You could even do It with 
a normal OS-9 coaaand like copy or echo. 




• Latest Hardware 

• Newest Software 

• Technical Sessions 
for 6809 & 68000 



Meet people making it happen in 0S-9 Ihe movers and shakeis 
who are helping 0S-9 become the fastest giowtng operating 
system for the 6809 & 68000 in the world. 
Lively and informative round-table discussions will cover the 
design and use ot Microwatt Software. We'll also discuss 0S-9's 
dynamic growth from where we am today to where we may be 
in the future. 

The exhibit area will feature booths from many ol the leading 
suppliers ot 0S-9 compatible hardware and software. It's a great 
opportunity to increase your skill and knowledge in the latest 
microcomputer software technology. Plan to attend — Register 
Today 1 

Seminar only $150 Hotel Package' $350 
Location Marriott Hotel, Des Moines, IA 
Don 't Miss It — Pre-Register Now! 
Call 515-224-1929 or Write 
MICROWARE SYSTEMS CORPORATION 
1866 N.W. 114th St. • Des Moines, IA 50322 



— TWetoHWO- 




'Hotel package Includes 3 nignls, single occupancy a/ me Marriott Hotel 

and legislation he. 

OS-9 and BASIC09 ant bademaiim ot Microm/bre and Motorola 
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You can even aek (or a directory of pipe naaea with 
a command like: 



0S9 dlr /pipe.* 

You can have aevcral dlfterenc pipe device descriptors 
it you like. I'll get Into why that'a Important aoae 
other time. 

You can look at eventa two ways. They are an 
efficient type of algnal fro* one proceaa to another, 
and they are a way of serializing the uae of aoae 
resource. A print spooler ahould be simple to write 
ualng a combination of a naaed pipe for input to It, and 
an event to serialize acceaa to that pipe. 

Either naaed pipes or eventa would be sufficient 
to «ske writing service processes for 0S-9 nuch easier. 
I certainly hope that Nlcroware's policy of keeping 
OS-9 for the 6809 aa compatible with OS-9/68K. aa 
possible will bring the oB09 community these featurea. 

NCI Hall 

An electronic aall system that would reach to our 
non-coaputerlzed friends would be a great thing. Sven 
those poor people using operating ayateas other that 
OS-9 would be able to take advantage of it. 

I read the review of NCI aall in Byte a few aontha 
ago. When I bought ay NIC Starlett aoae of the 
literature that caae with It encouraged me to subscribe 
(Is that the right word?) to NCI aall and Oow Jonea. 1 
had been sitting on the fence and the Starlett pushed ae 
over. [ aade the toll-free csll and Joined up. 

The problea with electronic aall ss It stsnds la 
that It can only reach other regular computer users who 
are hooked Into the aystea. I subscribe to Coapuaerve 
but 1 can't afford to uae It any more. It la very 
convenient for people on Coapuaerve to aend me aall but 
I'll never know that lt'a waiting for ae. I'a not a 
"regular uaer" of that ayatea any sore. My Bother haa a 
coaputer (of course) , but she lan't hooked Into any fora 
of electronic aall. 1 have to print out letters to her 
and aend thea through the postal service. 

The people who designed NCI aall evidently had 
theae problems In alnd. The syatea effectively deals 
with thea. There sre five claaaea of aall. The leaat 
expenalve la purely electronic: you aend the letter froa 
your phone, when the recipient checka hla MCI aall (by 
logging on) he'll get It. If you want to aend aall to 
aoaeone who doean't check for aall regularly, you can 
pay an MCI operator to call hla and tell hla that NCI 
nail Is waiting tor hla. IE the recipient doesn't 
subscribe to NCI mall or can't get electronic aall for 
aoae other reaaon and tlae la auch acre laportsnt than 
aoney you can have the letter printed on a laser printer 
and delivered within four houra by a courier. The next 
level down gets you next-day delivery of laaer printed 
output. The aloweat delivery la laaer printed and 
delivered via US aall. 

The problea with a purely electronic aall ayatea la 
that it la only useful when a large fraction of your 
correapondents aubacrlbe. NCI gets over that huap by 
offering a faally of hard-copy aall aervlcea. It la 
crucial that the hard-copy aall aervlcea be better or 
cheaper than conventional aall. The faat delivery aodea 
compete with the delivery aervlcea like Federal Expreaa 
on price. A alx page NCI letter for next day delivery 
coata $8.00. Letters that go through the poatal ayatea 
are printed at "the print alte nearest lta destination" 
and aalled froa there. Although the post office does 
strange thlnga It aeeaa reaaonable to expect letters to 
arrive faater If they are aalled froa closer to their 
destination. 



**** Editor's Note: 



Ain't SO, Fete! I ! 
DNW 



The Idea behind NCI aall la excellent. They cover 
all the anglea. Unfortunately It falls apart completely 
when It comes to execution. Let ne tell the atory In 
order. 

1 got a nice package froa NCI on a Thursday. There 
waa a letter with ay uaerld and paaaword, a tutorial 
annual, a users aanusl, a price Hat and a Hat of 
acceaa phone nuabers. 1 wss pleased to notice that 
Rochester was on a abort Hat of cities with free phone 
access, but It worried ae. lan't MCI a phone coapany 
that services all ctclas? I thumbed through the 
aanuala. They auat have been aimed at the very novice 
uaer. 1 felt bored and uninformed. [ decided to wing 
It; l Just celled the nuaber snd logged on. 

It worked fine. The softwsre la well designed. 
The online help la clear and more coaplete than the 
manual. I waa greeted with headlines froa the day'a 
news " which I appreciated becauae 1 hadn't heard any 
newa that day. Without any trouble 1 sent ayaelf an 
electronic message and a hard-copy letter. 

1 checked for the electronic measage that I aent 
ayaelf. Nothing. I logged off and on again. Still no 
aeaaage. Kama. Well I'd look the next day. 1 aent 
both aeaaagea around 11:00 In the evening. I expected 
the printed letter to arrive on Saturday. 1 really 
expected the electronic aall to arrive immediately, but 
trldsy would be line, 

I logged In frlday. My aall to ayaelf had arrived. 
I waa lapreaaed again with the softwsre. Very nice 
design. 

I waited for the printed letter to ayaelf on 
Saturday. When It didn't arrive on aonday 1 called MCI. 
Waa there a problea? Had I alaunderatood? 1 had 
misunderstood . Letters were Indeed aalled froa the 
nearest print alte, but there were only a tew (tour I 
think) to chooae froa. The neareat one to ae waa New 
York City. I logged Into HC1 again and checked aoae 
more help fllea. I discovered that the 4-hour aall waa 
restricted to a few cities. New York was on the Hat, 
but the other cities In the section of the country that 
I checked weren't, not even Soatonl 

Ny letter arrived on wedneaday. it waa poataarked 
August 2 (they aalled It promptly) froa lndlanapolla. 
What happened to New York Cltyt Soaehow they aanaged to 
make It look like Junk aall. Naybe It waa the 
International orange envelope. If 1 hadn't been waiting 
for a letter froa NCI I would have chucked It In the 
traah unread. 



The first page of my letter waa a c 
to ahow through the windows In the enve 
sddreaa and return addreaa. It alao had 
NCI "MCI Nail The natlon'a new poa 
Batched the one on the envelope. Not ve 
next page contained ay letter. The 

another copy of the NCI ad. Well 

thea a letterhead. I suppose they had t 

1 paid cloae attention to the quail 
printing. It waan't bad, but I've seen 
matrix prlntera. 



over page aeant 
lope. It had an 

a big add for 
tal ayatea" that 
ry claaay. The 
letterhead waa 
I hadn't given 
o uae soaethlng. 
ty of the lsaer 

better froa dot 



Of courae, all the best people sre lsser printing 
their correspondence thexo day*. Nothing wrung with 
lsaer printed letters. NCI csn even print your 
letterhesd (black and white) snd signature If you like. 



Let ae auaaarlze. NCI electronic aall la good; 
aaybe even excellent. lt'a well thought out and well 
Implemented. I only wlah they had free acceaa froa aost 
plsces. 

1 aay try their overnight aall aoaeday. The price 
la good and I'd like to know how It works. They don't 
deliver 4-hour aall anywhere I'a tntereated In. 

1 won't send the kind of letter I aent ayaelf to 
anyone elae. I'd be eabarraeaed. Why should 1 pay 
$2.00 to aend a letter that looka like Junk aall. 

I think electronic aall for the aaaaea la going to 
have to wait for a coapany that la ready to rlak more 
aoney. Too bad. 



18 



November '85 



f}8" Micro Journal 



"C" User Notes 



fdgar H. (Hud) Pass, Ph.D. 
1*54 Latta Lam 
Conyers, Ca 30207 

INTRODUCTION 

This chapter dtacuaaea Che Jsnes HcCoah series of C 
compilers for several operating ayateu which run on Che 
6809. Thla C lapleaentatlon la sLaost coaplete and haa 
tmuy versions lor Klex (nsrki-lud by wlndruah and K.E. 
HEU1A), UnlFltix (asrketed by MPU) , and OS/9 (marketed by 
Hlcroware and Tandy). Although there are differences 
aaong the lapleaentatlona , they are all very alallar and 
the others are upward-coapat Ible from the Flex version. 
They are all described below. 

SCOPE OK IMPLEMENTATION 
The HcCoah C coapller Is a rather coaplete 
implementation of the version of UNIX C described In 
Kernlghan and Ritchie (K 4 R) . 

The prlaary restrictions and differences In the HcCoah C 
coapller are aa follows: 

a. Bit fields are not supported. 

b. Constant expressions for Initializers aay 
Include arithmetic operators only If all the 
operands are of type *int*, 'unalgned* or 'char'. 

c. The older foraa of aaslgnnent operators ('-+* 
and '"*") which are recognized by aoae C coapllera 
are not supported. 

d. "Ifdef" (or "lfndef") "...else..." "endlf" la 
supported but "If <conatant expreaalon>" la not. 
Theae constructs aay not be nested. 

e. It la not possible to extend aacro definitions 
or strings over aore than one line of source code 
with the '\'-new-llne sequence, aa used by UNIX C. 
t. The escape sequence for new-line C\n') does 
not aean line-feed (hex OA) rather, It means 
csrrlsge- return (hex OD) . All progrems which use 
'\n' for end-of-llne will work aa Intended. 

g. "Unsigned char" Is not supported, 
h. Hany variants of the "Include" construct sre 
not allowed. The file name auat be encloaed In 
quotation aarka ("} or broken brackets (<,>). The 
foraat of the file names In this and In other 
constructs are dictated by the operating system 
under which the prograa la to be run. 
1. The uae of reglater variables la highly 
restricted. 
The prlaary extenelona to the langauge are aa follows: 

a. The type-epeclf ler "direct" aay be applied to 
global variables to Indicate that they are to be 
collected In a apeclal area addreeaed by the 6809 
direct page reglater. Since only 236 bytes aay be 
addreaaed by the direct page register, only a 
Halted nuaber of varlablea aay be declared with 
type "direct". The prlaary effect this 
type-apeclf ler hae on aost users Is to prohibit any 
uae of tha word "direct" aa a variable name. 

b. A line beginning with "laaa" switches the 
coapller Into a aode which paaaea all subsequent 
lines not beginning "lendaam" unchanged to the 
output. Thle Is s useful facility for Inserting 
lines of asaeably code. 

c. The escape aequencea for non-prlntlng 
characters In character conatanta and strings are 
extended ae follows: 

line-feed LF U 
which la to dlatlngulah LF (hex OA) froa "\n", 
which Is the same as "\r" (hex OD) . 

d. Bit patterna In the following foraa are 
aupported: 

\*** octal constant 
\d" declaal conatant 
\x" hexadecimal conetant 



Other lapleaentatlon differences are be covered later In 
thla chapter; however, several are ae followe: 

a. "Char" varlablea are algned, and there la no 
provision for unsigned char varlablea. 

b. "Float" and "Double" variables do not 
neceaearlly have the aaae foraat In the HcCosh C 
series of coapllera aa In the UNIX C coapller. 

c. Redirection of standard Input and output fllea 
under Flex la performed using the I and Flex 
coniunda, rather than the familiar "<" and ">" 
symbols. Thla restricts redirected text fllea to 
containing text, not binary, data. Since the I 
command la really a Flex utility which reada a dlak 
file and awltchee back to the conaole on end of 
file, the user must manually enter a control-D from 
the coneole to Indicate end of Input. 

IHPLEHBNTAT ION-DEPENDENT ITEMS 
Whereas the previous section discussed differences 
between the HcCosh C snd UNIX (K ft R) C compilers, tbls 
section discusses those lapleaentat Ion-dependent Items 
not covered In K i It, 

PRIMITIVE TYPE SIZES 

Each variable type requires s specific amount of memory 

for storage. The sites of the baalc types In bytee sre 

as followe: 

This coapller follows the UNIX C lapleaentatlon In that 

chars *re converted to Inte by algn extenalon, 'abort' 

or 'short lnt' aesns Int. 'long lnt' aeane long and 

'long float' aeana double. 

The format of a 'long float' variable la aa follows: 

one bit for sign 

six bytes snd seven bite for mantlaaa 

one byte for exponent 
The fori of the aantlasa la algn and magnitude with an 
Implied '1' bit at the algn bit position. The exponent 
is biased by 128. 
The format of s "float' variable la aa follows: 

one bit for sign 

two bytes snd seven bite for mantlsss 

one byte for exponent 

REC1STER VARIABI.E USAGE 

Zero, one, or two reglater varlablee aay be declared In 

any function. The only types peraltted for register 

variables are lnt, unsigned and pointer. Invalid 

register variable declarations sre Ignored (the storage 

claae le made suto). 

A considerable eavlng In code alie and speed csn be made 

by Judlcloua use of reglater varlablea. The moat 

efficient uae la made of them for pointers and countera 

for loopa. However, If regleter varlablea are uaed In 

complex arithmetic expreeelons, there are no ssvlngs. 

CONSTANT EXPRESSION OPTIMIZATION Becsuse the 6809 le sn 
8/16 bit processor, It le poselble to generate efficient 
code for 8 and 16 bit objects. However, code for 32 bit 
vsluea can at beat be four times longer snd slower. 
Further, It Is poealble within the conflnea of the 
6809'a memory limits to do aoae quite extenelve 
evaluation of constant expressions provided they Involve 
only constants of type char, lnt and unalgned. There La 
no provlelon In thla coapller for conatant expreeelon 
evaluation Involving conetanta of type long, float or 
double. Complex conatant expreaalone Involving theae 
typea are evaluated at run time by the coaplled prograa. 

ARITHMETIC ERROR PROCESSING 

The K 4 R book leavee the treatment of varloua 

arithmetic errors open, merely ststlng thst It le 

machloe-depsndent . This lapleaentatlon deale with a 

limited number of error conditions In a epaclal way; It 
ehould be aeaumed that the reeults of other possible 
errors sre undefined. 
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If an error occurs In an arithmetic routine which cannot 
be handled, control la paaaed back to the operating 
system, after placing one of the following meaaagee on 
the ayatem console (for Flex) or returning one of the 
following system error numbers (for OS/9): 

Flex 
*** FLOATING-POINT OVERFLOW *** 
»*• DIVIDE BY ZERO ATTEMPTED **» 
**» FLOATING-INTEGER CONVERSION OVERFLOW »»» 

OS/9 
EPPOVR 40 
ED1VEKK *1 
E1NTERR 42 



The UniFlex C 
processing. 



inual doea not specify such error 



STANDARD LIBRARY FUNCTIONS 

it Is essential to begin soy source file which uses the 

higher-level 1/0 functions from the standard library 

with 'Include <ntdlo.h>'. 

It output via prlntf(), fprlntfO or uprlntfO of long 

Integers la required, the aource must call ~pfllnlt()~ 

at some point; this Is necessary so that programs not 

Involving long variables do not have the additional code 

required to Implement long variable output. Similarly, 

If output of floating-point or doubles Is required, the 

source must call *pfflnlt()', 

COMMAND LINE ARGUMENTS 

Programs written In C which are Invoked with command 
line arguments can use the conventions outlined In the K 
& R book. The system Interface makes the arguments 
available to the program In exactly the manner 
described. Including the name of the program Itself as 
argv(Q) . 

Arguments are considered delimited by commas or spaces 
unless they appear within strings delimited by quotes 
("..."). This (a currently not true In the Hex 
Implementation, however. 

Redirection of standard Input and output files Is 
performed under Flex thru the use of the Flex I and 
commands. rather than thru the use of the standard "<" 
and ">" symbols. This la not a complete Implementation, 
due to the editing of output stream contents by the 
command and to the lack of end of file processing by the 
1 command. 



CREATING OBJECT FILES FROM C PROGRAMS 
The McCosh C compilers provide a simple means of 
compiling 6809 object code from s C program. 
Essentially the same technique la used for Flex, 
UniFlex, and OS/9 implementations of McCosh C. 
Thla involves the user entering a command line of the 
following format: 

CC flags fllel flle2 ... fllelO 
In which flaga provldea compiler optlona, aa described 
below, and the files provide the names of one to ten 
files, with explicit suffixes, as follows: 

,c ■ C source program file, 

.a - assembler source program file, 

,r - relocatable object program file, 

Actually, for the OS/9 version of McCosh C, there are 
two CC'a, named CCI, for level 1 systems, and CC2, for 
level 2 ayatema. They are referred to here collectively 
with the Flex and (JnlFlex versions aa CC. If one file 
naae la provided, CC will guide the execution of the C 
compiler phaaea , ultimately producing an object file 
with name usually having one of the formats "flle.CMD" 
for Flex, or "file" In the current execution directory 
for UniFlex or OS/9. 

If more than one file name la provided, the relocatable 
object files generated for each file name In the list 
will be saved, In addition to the generation of an 
object file usually named "OUTPUT. CHD" for Flex or 
"OUTPUT" for UniFlex or OS/9. These relocatable object 



fllea, named with aufflx of ".r", may be uaed with 
another CC or with the loader to avoid the recompllatlon 
of the Individual C programs. 

The optimizer pass may be selected to occur after the 
other compilation passes. It reads the ssseabler source 
code text and removes redundant code and searches for 
code sequences that can be replaced by shorter and 
faater equivalents. The optlmzer is claimed to shorten 
object code by about 1 1 Z with a corresponding increase 
in program execution speed. 

CC recognizee several command-line flags which modify 
the compilation process where needed. Since the command 
line is scanned before compilation commences, flags may 
be placed in any order on the command line. 
The following table deacrlbea the command-line flags for 
the Flex and UniFlex versions of the McCosh C compiler: 

+A - suppresses saaembiy, leaving the output as 

aasembler code in files with extension ".a" 

+0 - Invokes assembler code optimizer 

♦R - suppresses loading and linking, leaving the 

output as files with extension ".r" 

+L-fllename - specifies a library to be searched by 

the loader before the standard library and system 

Interface 

+F-fllename - specifies the name of the output file 

♦ C - inserts C source code as comments into 

assembler code 

-4-N - suppresses production of sssembler code 

+S - suppresses generation of stack-checking code 

+Did[«atrlngI - generates "fdeflne id vtrlng" aa C 

statement 

The flags may be run together except where a flag la 
followed by something else. 

For most simple and some complex C programs, CC makes 
the compilation process slmoat aa simple ss possible. 
With CC, McCosh C la easier to use than 1NTR0L C, which 
requires s separate linking step, snd Is easier to uae 
than moat Small C compilers except those which produce 
object code directly. 

The OS/9 version of HcCosh C uaea a slightly different 
version of the command line from that Just described. 
The following list describes the command-line flags for 
the OS/9 version of McCoah C: 

-A - suppress assembly, leaving the output as 

assembler code In files with suffix ".a" 

-E-number - seta OS/9 module edition byte to number 

-0 - suppresses the ssaembly code optimizer paas 

-P - invokes the profiler to generate function 

Invocation frequency statistics sfter program 

execution 

-R - suppresses loading and linking, leaving the 

output as files with extension ".r" 

-MaslzeK - instructs the linker to allocate size K 

bytes for dsts , stack, and parameter area 

-^'filename - specifies s library to be aearched by 

the linker before the standard library and system 

Interface 

-F-path - specifies the nsme of the output file 

-N - suppresses production of sssembler code 

-S - suppresses generation of stack-checking code 

-Did [-string] - generates "fdeflne id string" ss C 

statement 

The flags may be run together unleaa something else 
follows s flsg. 

The 0S/9 version of McCosh C provides s facility known 
aa the profiler. The profiler la sn optional method 
used to determine the frequency of execution of each 
function In a C program. It allows the ldent If lest Ion 
of most-frequent ly ueed functions. When the -P compiler 
option Is selected, code Is generated at the beginning 
of each function to call the profiler module, which 
counts invocstlons of each function during program 
execution. When the program has terminated, the profiler 
prints s list of sll functions snd the number of times 
each was called. 



OPERATIONAL PROBLEMS 
The McCoah C compilers share a few operational 



problems 
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with 1NTR0L C and probably Boat other FULL C 
lmplemenatlone on nlcroa. The primary onea Involve 
speed and storage. 

The apeed problems acen from aeveral sources. Even for 
very snail fllea (auch aa HELLO, which prints "HELLO, 
WORLD"), CC nuac load each of the other C compiler 
nodules. In turn, fron an attached disk or diskette 
storage device. Even with a hard dlak or virtual dlak, 
thla process coneuaea auch time. With SA*00-type 
mlnl-dlek drives, the wait could become very lengthy. 
The C compiler nodules generate (and read back) fllea 
representing various atagea of compilation of the 
original program, ao larger C programs could require a 
significant amount of dlak activity themselves. 

Internally, the C compiler modules do not aeem to 
require Inordinate amounts of processor time, but, 
again, larger programs will require significantly more 
internal time to process than amsller onea. 
Modularizing large programs may aaalat somewhat in 
reducing the time and effort required to maintain them, 
although there are major trade-offa to be considered in 
such a process. 

The dlak anil main memory atorage problema also stem from 
aeveral aourcea. The amount of dlak apace required to 
contain CC and the other C compiler object modules and 
required fllea may be quite large. 

Compilation of a C program by CC requlrea that the 
following or similar fllea be preaent on the ayetem 
drive under Flex; 

cc.cmd compiler executive 

cprep.cmd macro preprocessor 

cpsssl.cmd compiler paee 1 

cpaaa2.cmd compiler psee 2 

copt.cmd optimizer 

caem.cnd relocating assembler 

cload.cmd linking loader 

catart.r program Initialization module 

cllb.llb standard library functlona 

atdlo.h standard I/O definitions 

ctype.h stsndsrd type definitions 

aetjmp.h long branch functlona 

flex.h standard Flex definitions 

Compilation of a C program by CC requlrea that the 
following fllea be preaent In the current OS/9 execution 
directory; 



OS/9 Level 


1 Sy 


atema ; 


cc) 




compiler executive 


c.prep 




macro preprocessor 


c.paasl 




compiler paea 1 


c .paa»2 




compiler pass 2 


c.opt 




optimizer 


c.aam 




relocating aaaembler 


clink 




linking loader 



OS/9 Level 2 Systems: 

cc2 compiler executive 

c.prep macro preprocessor 

c.comp compiler 

c.opt optimizer 

c.aam relocating aaaembler 

clink linking loader 

In addition, a file called "cllb.l" contains the 
atandard library, match functlona, and ayatem library. 
The file "catart.r" le the aetup code for compiled 
programa. Both of theae fllea are normally located In a 
directory named "lib" on the ayatem'a default maaa 
atorage device, which la usually the dlak drive the 
ayatem la booted from. 

The combination of theae files would fill moat of a 
SS/SD 5" drive. In addition to the apace required for 
the compiler fllea, aeveral temporary fllea are created 
on the working drive or in the current data directory 
during compilation. At leaet three tlaea the size of 
the largeat source file (and lta Included fllea) ahould 
be available for theae fllea. Thla reatrlcta the elce 
of C program which may be compiled on a SS/SD 5" 
dual-drive ayatem to about 80 aectora. 



The amount of main memory required to contain CC and the 
other C compiler object modulea le significant. Under 
Flex and OS/9 level 1, the main portion of the compiler 
la apllt into two parte. Although thle la sufficient to 
allow the Flex veralon to operate normally, the OS/9 
level t veralon requires essentially all of the 
potential apace available (about 167 pages) alter OS/9 
la loaded, leaving no room (on many ayatema) for the 
extra copy of the OS/9 shell data apace required to 
operate CC. In eevere caaea, there may not be room 
enough to load one or the other paaa of the C compiler. 
Thla problem may be eomewhat alleviated by the 
generation of a minimal OS/9 ayatem containing aa few 
drlvera aa possible for the configuration, but memory 
apace on an OS/9 level 1 ayatem la extremely tight. 



ERROR DIAGNOSTICS 
Cood error dlagnoatlca are extremely helpful to the uae 
of a compiler aa sophisticated aa a C compiler. 
Unfortunately, many C compllera produce very cryptic and 
mlaleadlng diagnostic meaaagea, leading to the 
lmpreeelon shared by many people that the C language la 
obscure and strange, fit only for ayatem programme ra . 
The HcCoah aerlea of C compllera aeema to take great 
palna to provide good error dlagnoatlca, including the 
uae of English meaaagea (not error numbers) and a 
glossary explaining moat of them In greater detail. 
Most syntax error messages are preceded by the line 
containing the ayntax error with an arrow pointing to 
the offending Item. There are, unfortunately, a few 
undocumented error meaaagea which are, of course, the 
most cryptic 

The McCosh C compilers provide good error detection, but 
it la In the nature of compllera for structured 
languagea that one ayntax error In a program can cause 
the compiler to lose Its wsy snd stsrt issuing s serlee 
of apurloua error meaaagea. The reaulta of moat of the 
common errore are anticipated and generally do not cauae 
thla nulaance. If the number of errors becomes too 
large (more than 30), the compiler aborta. The error 
dlagnoatlca are In general aelf-explanatory , but tbe 
manual may help If tbe meaning appears a little obscure. 
Of the three HcCosh C manuals, the Flex manual la the 
beet and moat complete. In contrast, the Unlflex manual 
conalata almost entirely of a Hat of the library 
functlona. The OS/9 manual la almost aa good aa the Flex 
manual, but la not organized 
complete. The Tandy manual 
Mlcroware C manual. None of 
Introduction to the language, referring to K & R for the 
language definition. The Flex manual haa a unique touch 
in coloring the pagea of the aectlone for quick 
reference. 



aa well and la not aa 
la a reset veralon of the 
the manuals provide an 



THE HcCOSH L1NK.1NC-L0ADER 
The term 'loader' la mlaleadlng. In the early daya of 
computing, a loader had the task of placing a program 
and lta data in memory ao that it could be executed. It 
then had added to It the ability to search for 
aubroutlnea and loading them aa well. Thla Involved 
enaurlng that references from the program to theae 
aubroutlnea were correct, wherever the aubroutlnea were 
actually placed in memory. Next, it became neceaaary to 
be able to load programs Into different locations in 
memory and make sure that they would atlll refer to all 
ltema correctly. Thla la 'relocation' and 'linking'. 
Up to thla point, all the work of a loader waa done at 
run time. Every time the program waa run, the placing 
In memory, searching for aubroutlnea, relocation and 
linking waa done. Then It waa realized that time could 
be aaved by doing moat of thla work once at compile time 
and aavlng the result. The trade-off waa the 
requirement of more atorage apace for larger executable 
fllea. 

In modern operating ayatema, the tasks of tranaferrlng 
an executable file to memory and of executing it are 
carried out by the ayatem ltaelf. All aubroutlnea, 
other than calla to the ayatem, are carried within the 
executable file. 
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An obvious extension Co Che Ides of having library 
routines Is Co split s Large program lnco modules which 
have well-defined functions snd simple Interfaces Co 
each other. The advantages sre that a nuaber of people 
can work on different parts of the sane project and 
compilation and/or asaeably of individual nodules uses 
less machine resources. The loader haa the Job of 
linking then all together and searching libraries for 
routines which sre not contained within the prograa 
aodulea. The output of the loader la s complete 
executable file. 

The definitions of lsnguagea such ss C snd FORTRAN stsce 
that parta of a prograa nay be separately coaplled, so s 
linking loader la essential for their full 
Implementation. 

PROGRAM SEGMENTATION 
There are basically two uaea of memory by a running 
program. The flrat la for the executable code which 
ahould not be modified at any time by the program 
Itself. The aecond uae of meoory la for the data which 
the program worka on. In general, thla memory la uaed 
for both reading snd writing by the program. 
The loader muat collect together all the executable code 
ptecea from the various aodulea and library routines and 
place them In a single block In the output module. It 
muat also determine how much data memory Is required by 
each module and fill In the total In a part of the 
output file reaerved for Information for the ayatem. 
In doing theae two taaka, the loader muat keep track of 
the offsets of all Important locations In both memory 
sections snd alter the executable code ao that 
reference* are to the correct placea In the final 
program. 

It la often convenlenc Co have Initial values In parts 
of the data portion of memory at the moment the program 
starts running. Some lsnguagea, notably Paacal, have no 
notion of thla, but FORTRAN and C are examples of 
languagea where data Initialization la possible. The 
vslues set In this wsy sre not necessarily fixed for the 
duration of the program ao they auat be In the data 
portion of nemory. 

The loader handles this by maintaining a separate 
'segment' for Initializing data which la distinct from 
the non-lnltlallzed memory. The names for the three 
segments sre traditionally (at leaat on the PDP-11) the 
following; 

text executable program code 
dsts Initialized data areaa 
baa uninitialized data areaa 

For the 6S09 processor, It Is highly desirable to make 
ss much use ss possible of the more efficient addressing 
mode available when acceaalng memory in the 'direct 
page'. There La, therefore, a fourth aegment for thla 
purpose celled 'direct'. 



Host users will never use CLOAD directly, ss the detslle 
sre tsken care of by the CC routine when It produces 
programs which run under sn operating systea. Only 
those desiring to produce complex object modules or 
modules for stand-alone operation will ever uae the 
linking loader directly. 



LOADER OPERATION 
The output froa the asseabler Is In the form of s 
'relocetsbie module' which contslns the executable code, 
Initializing dsts snd tsbles of Information to enable 
the loader to link It with the rest of s program. A 
'library' file 1b a collection of relocatable aodulea. 

The output from the loader la an executable program 
module In the form required by the operating ayatem. 
The loader takea aa command-line arguments the namea of 
a number of files containing relocatable aodulea and 



possibly one or more library files which are sesrched 
for unresolved referencea. 

The ayntax of lta command line (under Flex and UnlFlex) 
la aa follows: 



CLOAD loptlons) fllel |flle2 ... ftlen] 
In which options sre described later and fllel thru 
fllen are relocatable object aodulea. 

The ayntax of lta command line (under OS/9) Is aa 
follows: 

CLINK loptlons] mslnflle laubfllel ... subfllenj 
In which optlona are deacrlbed later, 'cstart.r' la the 
usual name of the malnflle, and subfllel thru subftlen 
sre relocatable object modules. 

The command line arguments to CL0AD/CL1NK consist of one 
or more relocetsbie modules snd, optionally, one or more 
libraries. The relocatable modules must have been 
created by CASH. 

Tha alze for each module la Halted to about 25k bytes 
but there la no loader-Imposed Halt to the size of the 
final executsble code. 

The output file Is, by defsult, named 'OUTPUT' and la 
placed on the work drive tor Flex or In the current 
execution directory for OS/9 and UnlFlax. 

The loader vlewa a program as consisting of three 
distinct sress of memory. The flrac la Che 'text' 
aegment which contains the code of the progrsm Itself 
snd sny Initialized dsts such as string constants. The 
second Is called the 'direct' segment which contslns 
variables which are to be accessed using the short 
direct addressing mode Instructions of the 6009. The 
last Is called the 'baa' aegment, which la reaerved for 
memory which will be uaed by the program but which haa 
no particular valuea assigned to It by the progrsm 
before execution. In C, these sress sre reserved for 
all the global and atatlc variables but the language 
definition ststes thst sll such un-lnltlsllzed variables 
neve the vslue zero st the stsrt of execution. 
Following sre the options for the Flex snd UnlFlex 
versions of the linker: 

+M - prints s losd map of the aodulea providing the 

baae addreaaea of the conatltuent aagmenta. 

+S - prlnte a symbol tsble of assigned addresses 

for sll globsl symbols. 

+T»addreas - specifies the stsrtlng address of the 

'text' segment of the program; It atarta at zero by 

default. 

+B-addreas - specifies the starting address of the 

'bss' segment of the prograa; It starts Just beyond 

the 'text* segment by defsult. 

+L-f llensme - specifies the name of s library file 

to be sesrched for unresolved external references. 

+0-fllenaoe - specifies the nsme of the output file 

Into which the executsble progrsm code Is plsced; 

lc Is nsmed 'OUTPUT. CMD' by defsult. 

Following sre the options for the OS/9 version of the 
linker: 

-a - prints s losd map of the modules providing the 

bsse sddresses of the constituent segments. 

-s - prints s symbol tsble of assigned sddresses 

for sll globsl symbols. 

-1 -filename - specifies the nsme of s library file 

to be aearched for unresolvsd sxternal referancea. 

-o-fllensae - specifies the name of the output file 

Into which the executable program code la placed; 

It Is named 'OUTPUT. CHD' by default, 

-e-edtlon * specifies the edition nuaber for the 

output module. 

-m-slzeK ~ overrides the size of the dsts sres of 

the output module. 

-b-entry - specifies the name of the entry point of 

s module to be celled from BASIC09. 

-t - allows ststlc dsts to sppesr tn a 

BASlC09-csllsble module. 
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STAND-ALONE OODK FROM C 
C la an excellent language tilth which to write programs 
Intended for uae In atand-alone environment* and for 
applications auch aa process control. CC supports such 
programing, but the aesns of producing the flnsl code 
Is not ss strslghtforwsrd ss for progrsas Intended to 
run under sn operstlng systea. 

The procedure to be followed depends primarily upon the 
sppllcstlon snd the fora of the flnsl code desired. 
CC Itself Is sn executive program which determines what 
hss to be done by the vsrlous constituent psrte of the 
coapller, csuses the operstlng systea to execute thea In 
the correct order, snd ensures thst the file names 
conform to conventions. 

If the "*A' option Is used when Invoking CC, the 
processing Is stopped before sny esseably takea plsce. 
It may be Instructive for the ueer to Inspect the code 
produced, particularly If the '*C option - source lines 
to be output with the esseably code as cooaents - Is 
slso used. At this stsge, the code could be used aa a 
aource nodule for aaaenbly with others. 
If the ~+R" option Is used, the outputs sre relocatable 
modules which may be link-loaded ualng CLOAD with other 
modules either froa single files or llbrsrles of 
modules. It Is st this stsge thst control csn be 
exercised over the locstlons of the text (executable 
code and Initialized data area) and baa (uninitialized 
data area) segments. 

Since many of the stsndsrd library functlone call 
operating ayatea functions, their uae must be csre fully 
monitored or entirely ellmlneted by coding equivalent 
routines In C or ssseabler by the asae names. 



C STANDARD LIBRARY 
The C standard library contain* functions which fall 
Into the following claaaea: 1/0 and convenience. The 
HcCoah C manuals provide complete llata of the nsaee end 
wage for each function In their reapectlve atandard 
libraries. 

The I/O functions provide fscllltles normally conaldered 
part of the definition of other language*; for example 
the FORMAT ststeaent of Fortren or the PRINT statement 
of BASIC. The main benefits of their lncluelon sre esee 
of uee snd compatibility with programs written for other 
environments. 



There sre two cstegorles of 
difference between thea nay csuse 
I/O operstlons sre performed 
functions which correspond to 
described In K 4 R. All the cs 
available In Flex (except 'lseek' 
aoat uaera will prefer to perfo 
the 'higher level' functlona deac 
chapter of K & ft. Thla le 
versatile and eaaler to uae. The 
uae the lower-level onea aa t 
operating ayatea Itself. The a 
the higher-level functions snd 
In the aethode of Identifying ope 



I/O functions snd the 

confusion. The bselc 

uelng the lower-level 

'systea cells* se 

lis aentloned there sre 

snd 'eeek'. However, 

ra 1/0 operstlons using 

rlbed In the previous 

becsuse they are mora 

higher-level functlona 

heir Interface with the 

In difference between 

the lower-level onea la 

n files. 



The lower-level functions uss file deecrlptors which sre 
small Integers. Pile descriptors 0, 1 snd 2 refer to 
the stsnderd Input, stsndsrd output snd stsndsrd error 
'files' which sre slwsys open from the stsrt of program 
execution. The tern "stsndsrd Input' normally refera to 
the user's terminal keyboard but a»y In fact be froa a 
flla If the operating ayatea'a redirection ability la 
Invoked, Similarly, 'atandard output' refera normally to 
the tsralnsl screen but may have been re-dlrected to a 
file. The 'stsndsrd error output', however slwsys refers 
to the terminal so amy be used to direct error mesesgee 
to the screen where they will not eecspe sttentlon even 
If other output le going to a file. File descriptors 
for other files sre obtslned froa cells to 'open' or 
'creete' end ere used to Identify the file for 
subsequent cells to other lower-level functlone. 



The higher-level functlone use file pointers which sre 
pointers to structures maintained by theee functlona. 
The File Pointer for en open file le obtained froa a 
call to "fopen* en die uaed to Identify the file In 
eubaequent calls to other higher-level functions. There 
ere three file pointers declsred In "etdlo.h" which 
repreeent 'files' which sre open froa the stsrt of 
execution: 'stdln', 'stdout' snd 'etderr' correspond to 
File Descriptors 0, t snd 2 respectively. 

The convenience functlone Include fscllltles for 
copying, comparing and concatenating atrlnge, asking 
nuabers out of strings, clssslfylng chsrsctere, etc. In 
addition, for OS/S and UnlFlex, they Include direct 
syetea calls for performing verloue operstlng systsa 
specific tesks. 

McCoah C sseuaee thst ths vslue of en undeclsred 
function le of type lnt, Just ss K & R speclflee. 
However, to obteln correct type converelone (or to evold 
unwanted onea), functions returning non-lnt veluee must 
be pre-declsred, ss deecrlbed In en earlier chapter. 

ACCESSING HARDWARE IN C PROGRAMS 
There ere e nuaber of technlquea for acceealng hardware 
In HcCoah C programs. Ths definition of C ensbles the 
programmer to dlepenee elaost entirely with esseably 
code except In very rere ctrcuastences. After ell, C 
wss developed for writing the UNIX operstlng systea. 
The first snd simplest aethod Is to uee s pointer. Any 
vslue may be esslgned to e pointer end the pointer 
subsequently used to scceee the sddreee. For an 
example, auppoee e hardware register le sddreseed et 
$11014. The following definition of e pointer would be 
edequste to eccees the register: 

cher *reg » OxeOlA; 
Thle deflnee e pointer celled *reg' which le tnltlellzed 
to contain the sddress of the register. The register 
aay then be acceeeed directly, as follows: 

vslue 1 » *reg; 
*reg » velue2; 

The eecond aethod srleee froa the ability to use sn 
Integer on the left side of the '->' operator ss If the 
Integer were e pointer velue. If e device le loceted st 
SE014 which hsd two registers, the following could be 
coded : 



struct | 
I; 



cher detreg, conreg; 



(define DEVICE! OxeOU 

The device could then be eccessed ee follows: 
DEVICEl->dstrsg • vslue 1; 
velue2 • DKVICKl->conreg; 

Note thet eccesslng hsrdwsre directly, while perfectly 
eccepteble In stsnd-slone mode end under Flex, le 
forbidden under UnlFlex end OS/9 level 2 (in user 
programs) and muat be carefully reviewed under OS/9 
level 1. It elao reducea the portability of C programs 
containing auch conatructa. 



SUMMARY 
The HcCoeh aerlaa of C coapllere, which waa deacrlbed In 
thla chapter, of fere e combat lble aerlaa of rather 
coaplete C coapller lapleaentetlone for Flex, UnlFlex, 
end OS/9, slaller In cspsbllltee and In acope to the 
Introl eerles of C coapllere for Flex, UnlFlex, and 
OS/9. 

Owing to differences In the operetlng ayatema and memory 
cepeclty, there ere alight dlfferencea among the 
producte. Virtually any program, written for the Flex 
veralon of thla product ahould run on the UnlFlex end 
OS/9 versions of this product with alnor chsnges. 
However, the UnlFlex end OS/9 verslone eech hsve 
divergent lsngusge extenelone froa the Flex verelon. 
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PART 7 - Ada'a Pscksges 

The package, aa a program structure, la unique to 
the Ada language. It provides the language with an 
Information hiding and modularization mechsnlsm that la 
much more functional than that provided by the 
subprogram. Packages are used to group — by means of 
encapsulation — other entitles of sn Ada program. To be 
effective In terms of good software design, of course, 
these entitles should share some common logical 
relationship with respect to the context In which they 
are used within the progrsm. Thst Is, those entitles 
encapsulated by a package should be logically related. 
Aa la the caae with subprograms, packages may be 
declared In two parts— the specification and the body-- 
and theae parts may be compiled separately. The 
specif lcatlon psrt is visible to other program units snd 
Itemizes the facilities provided by the package. The 
body of the package la hidden from other program units 
snd contains the Implementation details In terms of 
executsble code snd, perhaps, in terms of dsts 
structure. Thle two psrt structure aervea to provide the 
information hiding facility necessary to prevent s user 
of the pscksge from exploiting sny knowledge he may hsve 
of Implementation detail, which In turn prevents s user 
from developing code thst depends on the particular 
implementation of pscksge facilities. Thus, once the 
question of the pscksge specif lest Ion hss been resolved, 
the pscksge body may be implemented In sny msnner 
consistent with the specif lest Ion. Furthermore, the 
Implementation csn be modified st sny time snd In sny 
msnner thst preserves this consistency, 

The Ads entitles encapsulated within a package may 
be any entity that can be declsred In the lsngusge. 
This Includes dsts types, dsts objects, subprograms, 
tssks, and even other packages. In order for sn entity 
to be accessible outside of the pscksge, the declaration 
of the entity muat appear in the pscksge specif lest Ion. 
Horeover, the specification may be divided Into a 
visible part and a private part, and thoae entitles 
declared within the private part are not visible outside 
the pscksge Itself. Thus, users of the pscksge may not 
reference these entitles. The combination ot visible 
snd prlvste parts of a package apeclf lcatlon la used in 
the declaration) of prlvste dsts types, which sre 
discussed below. On the other hsnd, those entitles 
declsred In the visible psrt sre visible to outside 
users. 

A pscksge csn hsve a specif lest Ion snd no body. 
Such s situation occurs when the pscksge encapsulates 
only a group of type declarations, object declarations, 
or s combination thereof. These declarations are to be 
visible to other progrsm units, so they appear In the 
package specification. Since no aubprograma, taaks, 
packages, or generic units sppesr in the specification, 
there la no requirement for a package body. 

encapsulation of Declarations, It la not uncommon 
in large scale system development to hsve msny different 
subprograms use s common set of constsnt values, s 
common set of dsts types, or s combination thereof. To 
ensure coopst lblllty smong the various aubprograma — and, 
In the case of Ads softwsre, smong subprograms, 
pscksges, snd tssks--the declaration of commonly used 
entitles csn be encspsulsted within s pscksge. The 
pscksge csn be compiled snd then accessed by other 
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progrsm units. In this msnner, one csn be ensured that 
each program unit la using the same aet of declarations 
--something thst csnnot be assured If esch progrsm unit 
provides Its own declarst lona. An exsaple of this use 
of a pscksge is given below: 

package V0LUHE_C0NSTANTS la 

CU FI_T0_CU_HETER : constant :- 0.0283177; 

CUJKD_T0_CU METER : coomtant :- 0.764559; 

CU IN_T0_CU~METER : constant :- 1.638716E-5; 

»USHEL_T0_CU_METER : coomtant :- 0.035239; 

BARREL_TO_CU_HETKR : constant :- 0.119240; 

CAL_T0_CU_METER : commtaot :- 0.0037854; 

end VOLu"ME_tONSTAi«7S; 
This pscksge hss the specification ahown above, which 
contains only constsnt declarations; It has no body. 
Thla apeclf icat Ion may be separately complied snd then 
referenced by other progrsm units. Since the constsnt 
declarations appear within a package specif lest ton, they 
sre visible outside the pscksge. 

A second example Illustrates the use of s pscksge 
to provide dsts types for use by other progrsm units: 



package , 


\C STATE : 


is 




type 


VELOCITY 


la digits 10; 




type 


POSITION 


Is digits 6; 




type 


STATE is 
record 








X VEL : 


VELOCITY; 






Y VEL : 


VELOCITY; 






Z VEL : 


VELOCITY; 






X P0S : 


POSITION; 






Y POS : 


POSITION; 






Z POS : 


POSITION; 




i 


end record; 


end 


AC STATE; 





In genersl, Ads's pscksges are used in one of three 
wsys : 

- To encspsulste the declarations of closely 

relsted dsts types, dsts objects, snd constsnts. 
Cscksgea containing such declarations contain no 
subprograms or other progrsm units, so there need 
not be a pscksge body. However, s pscksge body 
csn be used to Initialise the vslues of dsts 
objects through the execution of sn optlonsl 
sequence of statements within the body. 
- To encapsulste relsted aubprograma, and perhaps 
other relsted progrsm units, In order to provide 
some sort of common service. By Including the 
specif lest Ion of the subprogram or other progrsm 
unit within the pscksge specif lest ion , it is msde 
visible outside the pscksge snd thus available 
for use by externsl progrsm units. Normally, 
this kind of pscksge will also have certain data 
types declsred In Its specification. 
- To create abstract data types by coupling the 
package concept with that of a private data type. 
The private data type and all applicable 
operations sssoclsted with the type sre declsred 
within the visible psrt of the pscksge 
specif lest ion — snd sre therefore visible to the 
user of the pscksge--but the detsils of the 
structure, representstlon, snd lmplementstlon sre 
hidden. 
Esch of these uses Is Important in the application of 
softwsre engineering principles for the purpose of 
enhsnclng the reliability, modi f 1 sbl 1 1 t y , snd 
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unde re tsndsbll 1 t y of software. They eld In Che 
reduction of the complexity of large software systems 
and hold promise for an Industry of reusable software. 
Esch of these three general applications Is discussed 
below. 

This package contains only s specif lest Ion part. When 
separately compiled and then referenced by other 
program units, this package provides the scalar floating 
point typea VELOCITY and POSITION, and the record type 
STATE. That la, other program unlta may declare objects 
of these types. 

Encapsulation of related program unlta. Certain 
procedures, functions, and perhaps even tasks, often 
hsve s relationship that binds them together In some 
logical fsshlon, even though they may not be dependent 
upon one another. for example, aubprograma providing 
for the implementation of trigonometric functions might 
be grouped together in the form of a package. In fact, 
packages of this sort are among the flrat to be 
developed or acquired by new Ada uaera, because they are 
often required In embedded ayatem applications. (Basic 
functions such sa square root, logarithm, real 
exponential, and the trigonometric functions, smong 
others, sre not contslned within the Ads language. The 
Intent la for each ussr to provide his own functions, as 
required end with the desired precision, through the use 
of the package structure.) An example Is given below In 
the form of s pscksge thst provides certsin matrix 
operations. Ilecause the package contains subprograms, 
both s s pec If les t ion snd body sre required. The 
specif icstlon is: 

package MATRIXAR1TK la 

type MATRIX la array( INTEGER range <>, 

INTEGER range <>) of FLOAT); 
procedure MATRIX_ADD(LEPT. RIGHT : In MATRIX; 

RESULT : out MATRIX); 
procedure MATRIX_SUB(LEFT, RIGHT : In MATRIX; 

RESULT i out MATRIX); 
procedure MATRIX_MUL( LEFT , RIGHT : In MATRIX; 

RESULT : out MATRIX); 
MATRIXERROR : exception; 
end MATR1X-AR1TH; 

This package declarea the single data type MATRIX — a two 
dlaenalonal unconst rslned array type — and the three 
operations MATRIX ADD, HATRIXSUB, and MATRIX_MUL. It 
alao declarea the exception MATRIX ERROR, which la 
Intended to be raised In the calling environment If the 
matrix dimensions sre not proper. Thus, another program 
unit may declare objects of type MATRIX, snd may slso 
call any of the three aubprograma to perform operations 
on those objects. The pscksge body must contsln the 
bodies of the three procedures. In skeletal form, the 
body would be 
package body MATRIX_AR1TH Is 

procedure HATRlX_ADD(LiFT, R1CHT : In MATRIX; 

RESULT : out MATRIX) Is 
begin 

—sequence of a tat amenta of procedure MATRIXADO 
end MATRIX_ADD; 
procedure HATRIX_SUB(LEFT, RIGHT : in MATRIX; 

RESULT : out MATRIX) la 
begin 

— sequence of statements of procedure MATRIX SUB 
end MATRIX-SUB; 
procedure MATRIX MUL(LEPT. RIGHT : In HATRIX; 

RESULT : out MATRIX) la 
begin 

— sequence of statements of procedure MATRIX MUL 
end MATRIXMUL; 
end MATRIX_AR1TH; 

The aequence of statements In each procedure body 
lmplementa the operation provided by the procedure. It 
will alao contain the Btateaenta necessary to check the 
dlmenalona of the two matrix operands, snd to raise the 
exception MATRIXERROR If the dlmenalona are not 
compatible. The apec If lea t Ion and body can be 
separately compiled, ao long aa the specif Icstlon Is 
compiled prior to compllstlon of the body. Once the 
specif lest ion Is complied, other program units msy 
reference type MATRIX snd procedures MATRIX ADD, 



MATRIX SUB, snd MATRIX_MUL, snd these units themselves 
csn be compiled even before the body of pscksge 
MATRIX ARITH Is compiled. The fact that program unite 
that use entitles provided by the pscksge con themselves 
be compiled prior to compllstlon of the pscksge body 
Illustrates the sbstrsctlon snd Information hiding 
features of the Ads lsogusge. 

Implement at Loo of abstract types. One of the major 
causes of problems in embedded system softwsrs — or in 
sny other lsrge scale program, for that natter—la the 
sheer complexity of the algorithms Implemented by the 
software. Many of the features of the Ada language 
permit — and even encourage — the uee of abstraction aa a 
technique for handling the complexity of large programs. 
Subprograms, for example, provide for abstraction of 
program control, so thst the user need only consider the 
input-output relationship implied by the aubprogram 
specif lest ion , rsther thsn being concerned with the 
Implementation details. In Ada programs, dsts csn also 
be abstracted by use of packages snd prlvste dsts typee. 
In fsct, msklng s type prlvste hss the lmmedlste 
consequence of msklng it abstract, st leest from the 
point of view of the user of the pscksge. Thst is, the 
structural details of the type are hidden, and there are 
no literals that can be assigned to objects ot Che type. 
All that la vlalble to the uaer la the name of the type 
snd the operations thst sre sssoclsted with the type. 
While this concept may seem over-restrictive, there is 
benefit to be obtelned from the sbstrsctlon provided. 
Thst is, objects of sn abstract dsts type sre declered 
snd manipulated In the aama manner aa any other objecta. 
Th uaer need not concern himself with the details of 
manipulating objecta of the type, and he is thus more 
sble to concentrate on the higher level of design. 
Abstract data typea can ba provided as abstractions of 
the real world entitles with which the program ltaelf la 
concerned, helping further to manage the complexity of 
aoftware by making it more underatandable. An example 
of an abatract data type la the formation of a data type 
that la a flrat ln-flrat out (FIFO) queue. The package 
specification la given below: 

package QUEUE_OF_CHAR Is 

type qUEUI TYPE Is limited private; 

procedure RESET(QUEUE_NAM£ : In out qUEUE_TYPE) ; 

procedure PUT(ELEM : in CHARACTER; 

QUEUE_NAME : In out qUEUE TYPE) , 

procedure TAKE(ELEM : out CHARACTER; 

qUEUENAME : In out QUEUE TYPE); 

function IS_ErlPTY(QUEUE_NAME : in QUEUE_TYPE) 
return BOOLEAN; 

UNDERFLOW : exception; 
private 

type QUEUE_ARBAY is array( 1 . .4096) of CHARACTER; 

type QUEUEJTYPE la 
record 

VALUE : QUEUEARRAY; 
FRONT : INTEGER range 1..4096; 
BACK : INTEGER range 1..4096; 
and record 
end qUEUE OP CHAR 

Thla package specif lest ion contslns s visible psrt snd s 
prlvste psrt. Those entitles declared In the visible 
psrt — type qUEUETYPE, subprogrsns RESET, PUT, TAKE, sod 
IS_EMPTY, snd exception UNDERFLOW— sre visible to users 
of the pscksge. Those entitles declared In the prlvste 
psrt — type qUEUE_ARRAY snd the full declaration of type 
qUEUE_TYPE — are not visible outalde the package ltaelf. 
The declaration of type qUEUE_TYPE aa a private type la 
vlalble outelde the package, but the actual atructure of 
the type aa a record with two acalar componente and one 
array component Is not vlalble. The only operation 
permitted on objecta of type qUEUE_TYPE outalde the 
package are thoae provided by aubprograma whoae 
specifications sppesr In the pscksge specif Icstlon slong 
with the prlvste type declaration — In thla case, RESET, 
PUT, TAKE, snd 1S_£HPTY. Within the pscksge body, which 
must contsln the bodies of subprograms RESET, PUT, TAKE, 
snd IS EHPTY, objects of type qUEUE TYPE sre three 
component records ss specified in the prlvste psrt of 
the pscksge specif icstlon. Thus, sny operation provided 
for records or their components csn be used. The form 
of the pscksge body would be: 
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psckj*r bod; QU!!Ue_OF_UWN If 
procedure HtSCTJiJUEUF. NAME 

In out QOEUITYPE la 
bc«lo 

— sequence Qt atateawnta or procedure RESET 
•od RESET; 
procedure PlrflELP.H : lo CHARACTER; 

QUEUE HAKE In not QUIUK TYPE) la 
beclo 

— eoquence of statements of procedure PUT 
end PUT; 
procedure TAKJE<ELErl : oat CHABAcrgd; 

QUtUK_»w4E : In out QUEUEJTrr't) la 
belt a 

-- sequence of stetesenta of procedure TAKE 
and TUB; 
fusctton IS EHPTYfQVEUC NAME : 

lit UUKUr; TYPE) recurs SOOLEA* la 
be (Is 

— sequence of fttatrsents of function IS EMPTY 
end IS EMPTY; 
end QUEUE Of CHAR; 

Thus, In the package body where the FIFO queue la 
actually lap leaver, ted , object* of type QUEUE TYPE can be 
■anlpulated aa record* with one array component and two 
loteger component*. The queue ltaelf la represented by 
the array, while the two Integer component* point to the 
front and back of the queue. Outalde the package, 
however, objacta ot type QUEUE_TYPE are abatractlona of 
FIFO queue* and the uaer can only RESET, PUT, TAKE, and 
check 1S_EHPT¥. The actual Implementation la hidden. 
In fact, a completely different Implementation — for 
example, aa a linked llet— -could be uaed In the private 
part of the apaclf lcatlon and In the body, without any 
effect whataoever on the uaer. Aa before, the package 
apeclf lcat Ion and the package body can be aeparately 
compiled. 

The uaar of the FIFO queue package would typically 
declare objecta of type QUEUE_T»PE. For Instance, the 
declaratlooa 

QUEUE1, QUEUE2, QUEUE3 : QUEUETYPE; 

create three PIFO queue objecta that are abatractlona of 
tbe PIPO queue Implemented In the package body. The 
uaer can then perform operations auch aa 

PUT( ALPHA, QUEUED; 

which puta the character object ALPHA on QUEUE_I , 
without concern for the detail of the actual 
Implementation. It la, In fact, lapoaalble for a uaer 
program to examine auch detail, becauae the 
Implementation 1* hidden In the package body. 
Similarly, the operations 



RESKTC QUEUE 2); 



and 



TAKEf. ALPHA, QUEUE_3) ; 

perform abatractlona of queue operation*. The reader 
ahould note that any number of objecta of type 
QUEUE_TYPE can be declared. They may even be uaed aa 
componenta of arraya or record*. Operation* on all 
objecte of the type are provided by the package 
QUEUEOFCHAR. 

Generic package*. Generic uolta In Ada are generic 
subprogram* and generic packagea. In Part 6 of this 
aerlea the generic aubprogram waa dlacuaaad. Hare, the 
declaration and lnatantlat Ion of generic package* will 
be considered. Aa la the caae with generic aubprograma, 
the apeclf lcatlon of a generic package haa an additional 
part called the generic formal part, and this formal 
part may contain generic formal parametera. At 
Instantiation, generic actual parametera are aaaoclated 
with the generic formal parameters. Aa ta alao the ceee 
with generic aubprograma, a generic package may have 
type parametera, object parametera, and aubprogram 
parametera. The uee of a generic package can perhapa 
beat be ehown by meana of an example. The FIFO queue 
package deacrlbed above provldee an abstract data type 



that la a FIFO queue of character*. Suppoae that a 
almllar atructure that will provide FIFO queuea for 
Integer valuaa la dealred. Certainly a package could be 
developed to provide thla service, and auch a package 
would be Identical to package QUEUE_OF_CHAR , with the 
exception that the data type CHARACTER~would be replaced 
with the name of the dealred Integer data type. 
Alternatively, the FIFO queue package can be made a 
generic unit, for which the apeclf lcatlon would be: 

feoarlc 

ELEM_TYPE la private 
package GENKRAL_QUEUE la 

twpm QUEUE TYPE la limited private; 
procedure RESETCQUEUENAME | 

In out QUEUEQUEUE TYPE); 
procedure PUTCELEM : la ELBN TYPE; 

QUEUENAME : In out QUEUE TYPE) ; 
procedure TAKE(ELEN : In ELKM TYPE; 

QUEUENAHE ; 1b out QUEUE_TYPE) 
functloo ISEMPTYC QUEUE NArUi : la QUEUE TYPE) 

rstaro BOOLEAN; 
UNDER/LOW : exception; 
private 

typm QUEUE_AKRAY le srrsy( 1 . .4096) of ELEM_TYPE; 
type QUEUETYPE le 
record 

VALUE : QUEUE ARRAY; 
FRONI : INTEGER range I.. 4096; 
BACK : 1NTECER range 1..4096; 
and record; 
end CENERALQUEUE; 

The reader will note thet the only chengee ere the 
addition of the generic pert and the substitution of the 
generic formal type peremeter ELEH_TYPE for the type 
CHARACTER. Aa before, the apeclf lcatlon and body may be 
separately compiled. 

Peckege CENERAL_QUKUE la generic, end ea auch le 
not directly ueeble. An lnetence of the generic package 
muat flrat be declared. The following Instantiation 
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INTEGER QUEUE le new 
CENERAL_QUEUE( INTECER) ; 



produces pscksge INTECER QUEUE, which provldee en 
ebetrsct dsts type thet Is e FIFO queue of objects of 
the predefined type INTECER. The dsts types for which 
pscksge GENERAL_QUEUE msy be Instantiated ere not 
limited to scslsr dsts types. For exemple, if the 
declerstlons 

type WAY_ POINT la 
record 

LATT : FLOAT; 
LONG : FLOAT; 
sod record; 
type WAY_PT_ARKAY le array U..20) of WAYPOINT; 

are In effect, then the Instantiation 

pscksge WAY PT QUEUE Is new 

CENERAL_QUEUE(WAY_PT_AIWAY) ; 

will produce the Implementation of e FIFO queue for 
objects of type WAY_PT_ARRAY , which ere erreye of 
recorde. There le virtually no limit to the complexity 
of tbe dete typee for which package CENERAL_QUEUE can be 
lnatantleted. 

There ere fssturss of snd limitations to the 
pscksge snd generic features of the Ade lengusge thet 
ere beyond the ecope of the preeent discussion. 
However, even the simple exaaplea preaented here eufflce 
to Illustrate the ueefulness of the pecksge concept, the 
prlvete dete type, end the generic pscksge facility of 
ths lsngusge. Generic pscksgee, In particular, hold 
promlss for the development of e eoftwere lnduetry 
through which reueeble eoftwere components csn be ehered 
by many different programs. 

NEXT: Ads's Tssks snd Concurrent Programming, 

Ads Is s trsdemark of the U.S. Department of Dsfenee, 
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KABK TIRED, ACHING PINCERS 

Are your fingers clred of typing? Do you find yourssli 
entering Che taw repecltlve Ilnea? With you could leave 
s llet of things for your your computer to do, while you 
went s did nore fun things? Well, you can with procedure 
fUesI 

Normally, Input and output occurs between you and the 0S- 
9 shell. Actually, It's with the shell and your terminal, 
but eventually you end up pressing the keys and reading 
the display. If you Input from another source Into the 
shell, then you eliminate the the work. The way to do 
this, is to Input to the shell from a file. Entering: 

0S9:shell <some_flle 

causes another shell to be created whose Input Is fron a 
file called "some file". "Sone_flle" Is a procedure file, 
since It lists Instructions for the shsll to carry out. 
The "<" redirects Che scsndard lnpuc fron the keyboard to 
the file. Every line In the file looks to the new shell 
as If It had been entered fron the keyboard. There Is a 
stapler way to start this procedure file. Just enter: 

0S9:soms_flle 

This accomplishes the same thing that was done before. 
The difference la Che shell dossn't know initially that 
this la a procedure. At first, It aaauaee It could bs an 
executable, program module. So, It checks memory to see 
If It's there. Not finding It, It goes to Che execution 
dlreccory, usually /DO/CHDS. lc'a noc chere elcher. 
Finally, It decides this must be a procedure file and 
looks In the working directory for It. If It finds It, 
the shell will create a naw ahall for It that inputs iron 
Che file. In our case lc la "some file" again. If lc 
doesn'c find lc, you get an error 1216 which Is Bad 
Psthlist. 

The most familiar procedure file Is startup, located on 
/DO. What makea this file unique Is on "boot up" of the 
system, stsrtup Is automatically run. Startup Is a good 
place to set Initial parameters of your system. What you 
put In lc, la s maccer of personal whim. Usually Che 
simplest startup file (and probably the one that cane 
with your system disk) Is 

SET1ME </TEKH 

Setlme sets the time and date. Why the "</TEW1"? 
Remember, Che standard Input aa been redirected to cooe 
from a file. Setlme would run, try to get data from the 
rest of the file, and finding none would not aet the time 
or dace to anything meaningful. By adding the redirected 
Input from the terminal, you can type In Che necessary 
Information. Thla sounds like a circular argument, If you 
think about It, It makes ssnss. A shell's Input la 
redirected from the keyboard Co a file. The file contains 
an OS-9 command, which In Cum redirects Its Input from 
Che keyboard again. The greac thing la, tc workal 
You can customize startup Co your own liking. Hy startup 
file looks like: 

taode . 1 -upc 

xmode /p baud-4 

aetlme </tera 
Thla uaes tmoda to Curn on Che lower case. The ".1" la 
necessary since Che Input to the shell Is from the file. 
Tmode changes Che Cerialnals configurations by affecting 
lta path descriptor. The shell is using the file for Its 
Input, so the terminal la not effected , unless the ".1" 
Is sdded. Then tmode changea the parameters for the 
standard output path #1. The xmode changes the device 
descriptor for the printer, so It csn run st 2400 bsud. 
Setlme worka like It did before. 
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I like to uae procedure fllea while programming. It saves 
time and waiting. For example, when programming In 
Pascal, I first write the code using a word processor 
called Dynastar then 1 compile It with the Hlcroware 
pascal compiler. I create a little file, 1 call "do". It 
reads: 

ds program </term 
psscal <program >/p 

All I do is run "do", edit the program and then quit 
dynaatar. I don't have to wslt for dynsstsr to finish the 
file before entering the pascal line. 1 ssve s few 
keystrokes and don't have to retype the same repetitive 
line. Later I add the u e: 

pascsln pcodef 

to "do". Now I can run the p-code file after It Is 

compiled. 

A good uae of procedure fllea la with an OS-9 command 
called daave. To use It to copy a disk In drive to 
drive 1 use the following sequence: 

chd /dO 

dssve /dO >tempflle 

chd /dl 

/dO/tempflle 

Here daave makes a file called "cempfile" on /DO that 
contains the necesssry Information to copy the contents 
of /DO to /Dl. With a change of the working directory to 
/Dl, "tempflle" la run. tt uses aak/Hr, copy. load, tmode 
snd unlink Co copy everychlng from /DO Co /Dl. Here's 
snother way to do It. 

chd /dO 

daave /dO /dl 1 ahell 

This one creates a file that copies /DO to /Dl, but the 
twist Is the file is piped to a shell which In turns 
excepts It ss input and begins to execute It. 

Procedure files csn serve many purposes. They csn cause 
your computer to csrry out taaka that would take much 
time to enter from the keyboard, like daave doea. Many 
repetitious cssk can be placed In a file, like Che pascal 
programming example 1 used esrller. Later It can uaed 
when needed. I've noticed many aoftware packages use 
procedure files to Install their programs onto you dlak. 
The uses are only limited by you Imagination. 

THE SOLUTION 

One of the buzz words going sround is "user friendly." 
This computer or thst one contends that It Is user 
friendly. And there sre all types of gimmicks to make 
them friendly. Some are menu driven and you select sn 
Item from the menu. Others use Icons (thst's little 
pictures) that you select with a Joystick or mouse. 
Others play question and answer to find out what you want 
to do. The purpose of all of them is to make life a 
little easier for you. 

For those of you thst looking for something to make OS-9 
easier to use on your Coco, there Is THE OS-9 SOUmOM 
msrketed by Spectrum Assoclatee, Inc. The Solution ia a 
menu driven program designed to give you 26 OS-9 commanda 
at your fingertips. It purpose is "to mske OS-9 an 
eaaler to use dlak operating system." The commands are:; 



<A>lphabetlze Directory 
<B>sckup Diskette 
<Oopy File 
<D>elete Directory or File 
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<E>xaaIne Kile 

(f>orut dlakette 

<C>oto a New Directory* 

<H>elp Screens 

<I>nforaetlon On File , 

<J>uable Around Flleneaes 

OOompers File* 

<L>otd In A File To The Module Directory 

<H>ake A New Directory 

<N>ew Dlakette 

<0>uCpuC File 

<P>ut Fllea Together 

<Q>ult and Exit To OS-9 ( 

<R>enaae Current Filename 

<S>et Directories* 

<T>lme and Date Set t 

<U>p One Directory Level 

<V>erlfy File . 

Work Multiple File t 

OOmode Paraaetare Menu t 

<Y>-Dlaplay Free Sectora 

<2>-Execute Shell Command 

a 
The coaaanda aerked with the " " are billed aa coaaanda 

that are not available under regular OS-9. The 
Alphabetize Directory or Jumble Around Fllenamea ere two 
that you won't find. lnforaatlon On Files la like OtR E 
and 1DENT rolled Into one. I quaetlon whether they ere 
different In ell ceaee. Like their Reneae realnda ae of 
the regular RENAME In OS-9. In the end they do the a sue 
thing. 

The Solution lets you Manipulate fllee by an errow on the 
right hend of the ecreen (It la actually a •>). By 
preeelng the Coco'a up end down arrowa you aove the 
current directory fllee by It. When you are heppy with 
what you are pointing at, you eelect the function. If you 
went to output to a device, you get another acnu that 
ahowa the poeelbla devlcee, Ilka dlak drtvee, and the 
printer. Ageln the devlcee ere moved by the errow for 
selection. The entire goal la to be able to work OS-9 
totally froa a aenu. 

This asy be greet for soaeone stsrtlng out, but I sa not 
sure It Is for everyone. Conelder listing s file to the 
printer. In stsndsrd OS-9, I would enter: 

lilt (Uentae >/p 

end "fllensae" would go to the printer. With the Solution 
I would aove the file llet up or down pset the arrow until 
I found "fllenaae". Then I would press to output file. 
Another aenu would coae up aeklng for a direction. I 
would again aove the poeelble devlcea paet the arrow 
until I reached /p. Finally 1 would preaa S to aelect the 
device and "illenaae" would be listed to the printer. Now 
which Is eeeler? 1 don't find the old wey to be very 
dltflcult. (n feet, 1 feel acre In control with It. 

The Solution Is big. When I run It, It leevee ae with 
sbout 131 of aeaory for other things. If 1 give It extra 
aeaory ss they suggeet (sdd s #20k on the end of the 
execute line), I hsve slaost no aeaory left. You reslly 
csn't do auch else while lt'e running. It's not the type 
of progrea thst you'll leave In aeaory while you do other 
things. 

l'a not sure If the Solution Is right for everyone. Host 
of Its functions I feel aore comfortable with using ths 
old feshloned aethod. Soae of the benefits sre good. I 
like the Alphabetize Directory function end Work Multiple 
Files which lsts you asnlpulete aany files for copying, 
deleting, or whstever else you csn do with s single file. 
If you're soaeone who likes s aenu driven etaosphere or 
asybe you're Just stsrtlng out snd need the help, you 
alght be lntereeted In THE OS-9 SOLUTION. It I* svsllsble 
froa: 

SPECTRUM PROJECTS 

PO Box 21272 

Woodhsven, NY 11421 

718-441-2807 

cost: $59.95 plus s/h 



AlOTHXR DIRECTORY aJTEUUTlZKl 

As I aald earlier, I like the directory alphabetlzer 
function In the OS-9 Solution. Having the fllea In 
alphabetical ordar la not only eethetlcoJly pleasing, but 
It slso csn be ueeful. lasglne trying to locste e 
particular file In s large directory. You enter s D1R snd 
file nsaes spill out onto the screen. All you hsve to do 
Is find one nsae In the crowd. Now put thea In 
alphabetical order and quickly you epot the file. For 
those of you who don't hsve the OS-9 Solution, I've 
crested ■ directory alphabetize r called DALPHA. 

DALPHA is s C Language prograa. I coaplled It on the 
Mlcroware C Coapiler, but I think It can be easily done on 
aoae of the other onea. The prograa opens the directory 
In the "update mode" which peralts either resdlng or 
writing to It, If no parameters are paeeed to DALPHA, It 
sorts the current dsts directory, otherwise you csn 
specify s particular one. I've set UUIGTU to 130, the 
number of entries In the directory. You csn chsnge this 
If you like. Const is how aany entries were actually read. 
If there la more then the asxlaua, the prograa aborte 
without doing anything. 

The aort is s simple one, stsrtlng with the 3rd entry 
(the first two sre . snd ... with which we don't went to 
aess), the sasllest entry le locsted snd It la plsced 
here. Than the next saalieat la aought and eo on until 
all the directory entrlea are sorted. The procedure swap 
switches two entries. Copy moves sn entty fora one piece 
to snother. Coapsr* Is the most important routine. It 
decides which of two entries Is lsrgeet. If It returns s 
positive nuaber the first la larger; If It la negative, the 
aecond le larger; and a xero aeana equal, which ahould ba 
Impossible. Any entrlea stsrtlng with s V0' which la the 
bit value for s $00 sre returned so thst they go to 
bottoa of the sort. These sre old directory entries thst 
wsre st aoae tlae erssed. lnstesd of the entry being 
reaoved, s $00 wss plsced In the first position to flag 
It. Sometime later the alot aay be reueed for e 
directory entry, but for now we went thea at the and of 
the directory. 

At the end of the aort, the eorted directory la written 
back to the dlak end the path to It ia cloasd. This is 
the aos t critical part. U something hea gone wrong and 
erroneoua thlnga have been put Into the directory, your 
fllea (aa you know thea) aay be daatroyed. So here'a a 
aTaJUIUKSIt Be certain that DALPHA la running correctly. 
Try It on an old dlak. Or better, beckup some disk snd 
use it. If things go wrong. Just Bake another copy and 
try again. To coin an old phraee, "It la better to be 
aafe, then aorry". Wiping out an Important dlak can 
sake you very aorry t 

That'a all for thla month. Crank out aoae procedure 
fllea of your own. Take aoae of thoae repetitive taaka 
and let OS-9 handle thea for you. I think you'll really 
like DALPHA. It aakea your directories look ao auch 
better. Bye) 



/■ Program co alphabetize directories 

/• By Ron Voigti July b. l»«i 

/• For 68* Micro Journal, Basic OS-9 feeders 

/• Usage: 

/• 0S9:dslphe 

/• 0S9:delpha /dO/AJQKuJCTOSI 

/• TIM tlrst » temple alphabetizes the 

/• current working dsts dlrsccory. 

/' The second does a specified directory. 



/include tiidio.li> 

-define aaak(c) ((c)4'\l)7') 

Ida: ins D1X 128 

'define UPDATE 1 

/define LEKCTH MO 

'deltas D_UPUATE [>Ie>UFuATE 

/define E UAH 2»* 

'define EJttlTS 24b 

/define PS UK 12 



•/ 
•/ 
«/ 
•/ 
•/ 
•/ 
•/ 
•/ 
•/ 



aeiniargc, argv) 

let argc; 
char *srgv| I ; 

I 
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char entry! UUtCTHjtuSlZEJ; 

Lnt path. state, count, 1, ), pos; 

char *dlrnsmc«" ."; 

/* check tor too many parameters */ 
If («rgc>2>( 

prlntCC'Too Many ParamtersW); 

extt< I); 
I 

/* check Cor alternate dlrctory V 
it Urgc-»n 

dlrfleew-ArgvE 1] ; 

/* open "11 rectory and read 11 •/ 
II ((peth>open(dlrneM. tMJPDATK)) — • -1)1 
print I ("Can't Upan Xa\n",dl rnase); 
exlt(l); 
\ 

eount*0; 
white ((atate-rea4(path,enlrylcount*<f [ , 

b£l2K)»NuLU 
II (count -- UMCTH)( 

prlnttC'Dl rectory Too LergeW); 
oiltCl); 
I 
count — ; 
II (stale— 1) 
eiltUJtCAD); 

/■ aort the directory In ascending order »/ 
for (l-l; Kcount-l; 1«») ( 
poa-C ; 
(or U-t»l; J<count; J«-») 

It (cospare(e<itry|poi] ,e<itry|J I) > 0) 

poa-j; 
If (1 I- po«) 

ew.pletit.ryl 1) , entry! pue I ) ; 
I 

/* write out a directory */ 
It Ueeek(path.OI ,0) ---I) 
cill(l); 



for (i-O; Kcount ; !♦♦> 

II (»rlle(path. entryhj, 0S1ZS) 
e«lt(B_WUTE>; 

Clo*«j{p«th> ; 



1 



coaperele, t) 
char *a, 't; 
I 

lnt 1; 

If (alOl — '\0"> 
return! I > ; 

If (tlOl " '\0'> 
rcturo(~i) ; 

while ( «..k(»lll) — aukhl ll))l 
ll (a[ll > '\I77-J 

returo(O); 
elae 11 (t|l| > '\Ul"i 
return! 1): 

reti>cn(aaak(all|)~aaelt(t[in): 



awap!a, t) 
char «a, *t; 
) 

char teaporery|DSIZ£|; 

copy(a, temporary); 

copy(t. a); 

copy( temporary, t); 
I 

copytal, s2) 
char ••! . a»J; 
1 

tnt 1; 

lor (l-ui KDSIZE; H->) 
.2ll|-.lll]. 
) 
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For years now I (among many ochera) have been using 
Technical Syacem Consultants' UnlfLEX operating system. 
UniFLEX is kinds like the "big brother" of FLEX 
Operating Syatem which Is enormously popular all over 
the world. 

UniFLEX Is s multi-tasking, multi-user operating ayatem, 
written In assembler language and runs on the H6B09, 
M66OO0, H68010 and M6B02O microprocessors. UniFLEX la 
tailored for the machine architecture of these 
processors and takes full advantage of each machines' 
instruction set. More importantly, UniFLEX allows for 
much more sophisticated tools and techniques while 
developing software. More thsn one developer may 
participate, and ... more than one product may be 
developed at Che same time] 

UniFLEX, like UNIX, offers a variety of sophisticated 
mechanlama for management of the uaer environment. One 
such "feature" la of Course a "hierarchical" file 
eyetem. Thla one feature alone la probably the leaat 
appreciated aspect of UNIX-like syetems by the non-UNIX 
user. The eaaleat way to understand it is to visualize 
It, and the best wsy to appreciate it la to aee it as 
wsy of properly organizing similar filee, eg: by 
project, or by language, or by subject.. 

The UniFLEX file ayatem la organized with a root 
directory aa the starting point for all filenames in the 
ayatem. Remember, FLEX fllenaoea actually atart with 



their "dlskdrlve number." Obviously, FLEX allows the 
"drlvespec" to be either before, after or implied, but 
we've gotten uaed to that now haven't we? The same 
holda true for a UniFLEX directory (or path name). You 
either apecify a full pathname, or it la implied to be 
the "current" psth nsme. For example: 



The 



root directory 

is designated by — > "/" 



Other directories or fllea 



< — the lowest level. 



reaide below the root. 



"met/" "bin/ 11 "etc/" 'V.y/'^W/" 
snd ss sn example: 

"bob'/" "Joe/" "parvlt" 



7F 



uaer directories would reside here. 
Now our friend "Ron" (who by now really 
enjoys the UniFLEX ayatem) haa several 
dlrectorlee he maintains. One haa some 
articles he hsa written for a magazine 
in Tennessee. Another haa hla latest 
text editor project written in 'C and 
some other stuff. 



'flex notes/" 



74777"" 



"evaluations/" 



It la eaay to aee that "ron" haa hie act together and 
can find any file he wanta with little effortl Why 
there la even a utility to search for a file if he 
ahould forget where he put it. Afterall, "ron" could 
hsve written s "C" progrsm ss s quick teet , reported the 
results to his readers (remember the magazine) in hla 
"flex notes/" files but forget to move it into the 
actual article. 
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The simplistic flic ayatem on our example UnlFLEX ayacea 
la Intended to be vlaual aid for thla dlacuaalon. It 
lapllee that practically any ueeful coablnatlon of 
dlrectorlea and (Ilea could be conetructed. 



treata the allocated reaource like any other reaource 
and dlddlee bite, or whatever! 

Recent Endeavora 



The aoat useful thing 
that thlnga are "organl 
frequently uaed utlllt 
"bin/" directory (the dl 
by the command lnt 
frequently uaed prograaa 
at the "uar/" level (the 
utllltlee, uaer wrltte 
directory called "bin/ 
aearched. The "hoae" dl 
drive" on a elngla-uaer 



about UnlFLEX f 
zed." For exa 
lea and progre 
rectory that la 
erpreter. . .the 

realded In a 
ae are usually e 

utllltlea 
In the uaera "ho 
rectory la klnda 
ayatea. 



lie hierarchy la 

pie, the aoat 

■a realde In the 

searched flrat 

"ahell">, leaa 

bin/" directory 

xtended function 

tc.) Finally a 

" directory la 

like a "work 



1 will deacrlbe In detail the "ln'a and out'a" of 
UnlFLEX over the next few artlclea and pace along any 
trlcka I've learned ao that new uaera will enjoy the 
power and flexibility earlier In the learning curve. 

UnlFLEX haa grown. Yea, grown along with the uaer baee. 
Aa aore coaplex toola, languagea and aupport aechanleaa 
were required, they were developed to sect the needa. 
When UnlFLEX wae flrat Introduced (early 198D), aeveral 
faalllar toola cam* with It. The standard TSC Text 
Editor, the Extended TSC BASIC and lt'e precompiler 
were among the flrat. Soon to follow were PASCAL, 
FORTRAN 77, COBOL, an Enhanced Print Spooler package, 
and two Utllltlea Packagea. Additionally, the TSC Text 
Proceaaor (uaed for yeara by thla magazine) and a little 
known, but very powerful Sort/Merge Package were ■ lipped 
In for good meaaura. 

TSC waan't alone In producing toola for UnlFLEX uaera. 
Over In England and weatarn Europe, many groupa were 
developing producta that would take advantage of 
UnlFLEX. James McCosh haa captured aoat of the 
attention by Introducing hla "C compiler, a fine piece 
of work, that not only ran under UnlFLEX, but FLEX and 
OS-9 (by Hlcroware), In Buffalo, New York, a company 
headed by Joel Heckman (UDRI) Introduced a act of Data 
Baae Management toola along with a complete Bualneee 
Management Package dealgned to run under UnlFLEX BASIC. 
Stylograph Introduced their fine word proceaaor. The 
Hat goea on arid on, far to nuaeroua to Include here. 

One of the wildcat toola Introduced for the 6B09 UnlFLEX 
ueera la "FLEX under UnlFLEX." With few reatrlctlona, 
any properly written program, language or utility 
dealgned to run under the alngle-uaer FLEX operating 
ayatea can be run (In a aultl-uaer environment) under 
UnlFLEX! Juat think of It ... .practically the beat of 
both worlda. FLEX under UnlFLEX cornea with a act of 
atandard Utllltlea and aoae apeclal onea. The apeclal 
tools allow a user to crease "logics!" disk drives on a 
dlak ayatea mounted under UnlFLEX, 
alngle-denalty FLEX dlaka can be uaed 
modification on a UnlFLEX floppy device. Even UnlFLEX 
and FLEX fllaa may be freely exchanged between 
eovlronaenta. I have enjoyed thla feature on many 
occaalona while developing apeclal Industrial controller 
packagea under UnlFLEX, then moving them to the FLEX 
environment for In-depth teatlng. 

Early ueera of UnlFLEX were perplexed at the Inability 
to gain "direct" acceaa to hardware devices and memory. 
UnlFLEX purposefully reatrlcta auch acceaaea In order to 
prevent lt'e carefully controlled environment from balng 
"bombed" by a careleaa programming error, or 
woree. . .Intentional prying. TSC haa lnveated 
conelderable effort In protecting the uaer from 
deatroylng hla fllea, craahlng other uaera or the entire 
ayatea. So the big queatlon became . . ."How can we uae 
apeclal devlcea like 'video boards,' or 'tape 
controllera?' The anawer, certain UnlFLEX veralona have 
a ayetem level function that allocatee memory apace, or 
a particular hardware device aa a portion of the uaer'a 
progran epece . After the function call, the uaer simply 



Regular 
without 



For the paat year, I have been puraulng perhapa the moat 
exciting work of my career, evaluating UNIX-like 
operating eyatema for a large package handling company 
(you know . . .abaolutely, positively overnight, etc.1). 
There were eeveral conatralnta and even more "gotta 
havee" for auch an operating ayatea, but the moet 
lmportent were; 

o It MUST work like UNIX 

o It MUST aupport 'C language development 

o It MUST be portable acroaa a hardware family 

o It MUST be very FAST III 

With theee (and other) criterion clearly In mind, a 
diligent aeerch wea begun to find the Ideal operating 
ayetem for our choaen hardware. I ahould explain, and I 
will that we had already reaearched and selected an 
appropriate hardware baae for our package handling 
eyeteaa. Since there la quite a body of Information In 
that eubject alone, I will present It In a future 
article, in detail! 

You muat remember that almoat every hardware vendor hae 
hla favorite (eomattaea the only one they could afford) 
operating ayatem. If you listen to the vendor, they 
would have you believe that even the moat complex 
project development effort la a "snap" with their 
UNIX-derived, UNIX-port, eon-of-UNIX, 

whatever .. .operating ayatem. Believe me, nothing could 
be farther from the truth. Tbe aad fact la that pure, 
non-optlmliad UNIX la one of the "dogleet" (a technical 
term aeenlng alow, lacy, fat, ugly, etc.) operating 
systems thet can be in charge of a mlcroproceaaor I Too 
many hardware vendors, whilst puraulng that almighty 
dollar, will tell the "un-enllghtened" anything they 
think they want to hear. Am of late, moat people want 
to hear "UNIX," or aomethlng like that whenever they are 
trying to convince their company to purchase new 
technology. Furthermore, If these aaae vendora even 
think that performance could be en laaue they will offer 
to "benchmark" (another technical term meaning 'here la 
a program that la constructed ao that It rune faateat on 
our product') their machine and of course, will offer to 
provide samel Sadly, the ayatema look like UNIX, run 
like molasses snd eventually ere dlscsrded In favor of 
aore expenalve, leaa appropriate technology. 

Now, having asld all that, let ae now eey that I wanted 
an operating ayetem that could run on a mlcroproceaaor 
(specif lcslly ths HbBOOO fsmlly) and would be portable 
acroaa the family of producta offered. In aoae caeca, 
there would be 'real-time' requlremente. In aoat caaee, 
there would be eeverel taaka running, each communicating 
with the other and each dormant when not doing their 
particular Job. The operating ayatem had to be easily 
configured, low coet, well supported end documented. 
From the developers polnt-of-vlew, the operating ayatem 
ahould not lmpoae any reatrlctlona. For all practical 
purpoaea. It ahould look like UNIX) 

Many UNIX-like ayatema were examined and benchmarked. 
The documentation for each waa thoroughly examined. 
Certain "pet" teata were conducted by Interested parties 
during thla reeearch period. Whenever a difference (or 
dlacrepancy) waa dlacovered. It waa explored and a 
determination made about poaelble impact on development. 
Another phenomenon emerged during thle period of 
exemlnatlon and teatlng. Some hardware manufacturer 
ahowed a willingness to cooperate! Yea, actually 
cooperate with me and provide aupport for the effort. 
It aeeaa that aoae of the manufacturers had been "lead 
down the garden path" during the early daya of their 
product marketing efforta and moet of tham had been lead 
to believe that what the public wanted waa UNIX, or 
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K-BBSIC npdates in nom aTailable. If gtra 
parchaaad K-BBSIC prior to Jnlg 1, 1985 
ind nnsb to have gonr K-BBSIC updated, 
plaaia and $35 ancleaad with gonr maatar 
diak to Southeast media. 

K — BASIC undar OS-H and FLEX mill now compile 
TSC BHSIC, IBHSIC and XPC Sourca Coda Filaa 



«•>» TILC1 551 414 PVT ITH 

(615)842-4600 



2-4600 m 

^%t H al iff 

% $§•!« 

5900 Cassandra Smith Rd. 
Hixson. TN 37343 

lor Information 
call (61S) 642-4801 

CoCo OS-9" FLEX" 

SOFTUIARE 



K. — DliLjlLa nouj makes the multitude of TSC NBIISiC Software 
ouollable for use under 0S-9. Transfer your fauorlte BHSIC 
Programs to 0S-9, compile them. Rssemble them, and 
DBKKBQJ -- usable, multi-precision, familiar Software Is 
running under your fauorlte Operating Systeml 

K — BASIC CBS-B or rilll. inclaaHn aj the assembler 

$199.00 




Sculptor 



//# 



*-** 



' c e. 



$ ii, 



Mcroproceaaor Dmsmlopmoat a Ltd.'e Commercial Application Caaaracor Prograa provides a PAST 
Coaaerclal Application Development Cool unavailable Co Che OS-9 and UnlFLRX Ueer before. Develop iny 
Coaaerclal Application In 202 of Che normal required Clac; gain easy updating or cuacoalztng. PLUS, 
the Application can alao be run on MS-DOS and Unix aachlneal Sculptor handlea Input validation, 
complex calculations, and exception conditions aa well aa the normal collecting, displaying, reporting, 
and updating information In an orderly f aehlon . Key fields to 160 bytea; unlimited record size; (lie 
alxe ahould be held to 17 million records. Uttlliea I84M File Structure and B-tree Key files for rapid 
Accetm. Input and Output communication with other programs and flies plus a library of ISAM routines 
for use with C Programs. Run-time included w/ the Development package; a compiled Application only 
needa a Run-time Licence. Additional charge for Networked Units. Prices for Oarsmlopaaint Package/Iun- 
tlaa- Discounts available for purchases of 5 or mora Run-time Packages. 



-» / UnlPLBX — 








66000 UnlFlEX — MS DOS — 






IBM PC Zenlx 


4995.00/4175.00 


Altos Zenlx 


— $1345. 00/|2iS.OO — 4595.00/$] 


15.00 


KS DOS Network -- 


* 


aa 




UNIX 




— a ee PC DOS — * 


a* 




* Full Oevelopement Package 


« Run 


Time Pa 


ckage Only 


Full OfcX and Dealer Dlacounta Avail 


able) 




h^ III Special 


Buy Out 


III 


SPECIAL - Limited Quantity III Special Buy 


Out III J 


W ~" *«o» plm software 
















TSC Plct Utllltlee 


was 


$75.00 


Pa*, 


only 


454.00 




MANUALS ONLY 






TSC stale 


was 


$75.00 


Sj, 


only 


135.00 




TSC Baalc Precompiler waa $25.00 


Bam ooly 


420.00 


TSC attended Precompiler 


was 


$50.00 


■as. 


only 


133.00 




TSC Text Editor waa $25.00 


Bam only 


420.04 


TSC Taut Processor 


was 


$75.00 


bar 


only 


154.00 




TSC Debus waa $25.00 


Bam only 


124.00 


TSC rlex Precompiler 


was 


$50.00 


Bam 


only 


135.00 




TSC Mnemonic Assembler was $25.00 


Bam only 


$24.00 


TSC Flex Baste 


was 


$75.00 


■am 


ooly 


150.04 










TSC Fix Dlagneetlc 


waa 


$75.00 


Pax, 


only 


154.00 




COMPLETE 6400 SOFTWARE 






TSC Text Proctsaor 


was 


$75.00 


■aa, 


only 


154.00 




TSC Text Proceasor waa $50.00 


Bam only 


135.00 


TSC Aaaaabler 


was 


$50.00 


■aa, 


only 


135.00 




TSC Precompiler «■■ $50.00 


Bam ooly 


135.00 


TSC Debug 


waa 


$75.00 


■am 


ooly 


» 50.00 




TSC Diafoosttcs waa $75.00 


Bam ooly 


154.04 


TSC Precompiler 


was 


$50.00 


a^aj 


ooly 


135.00 




DISKS ONLY • 6400 Software 






TSC editor 


was 


$50.00 


■mm 


only 


$35.00 




TSC editor waa $50.00 


■am only 


435.00 


TSC Sort /Merge 


Waa 


$75.00 


■a*, 


ooly 


$50.00 




TSC Utilities waa $100.00 


Bam only 


470.00 


TSC Utilities 


waa 


$75-00 


■a* 


only 450.00 




TSC Assemblers wes $50.00 


Bam only 


435.00 




DISKS ONLY 












MANUALS ONLY - 6400 Softwere 






TSC ascended Precoapi tsr 


wss 


550.00 


■mm 


ooly 


135.00 




TSC Dlagnoat tea vai $25.00 


Bam only 


420.00 


TSC Basic Flax 


wss 


S75.QO 


■mw 


ooly 


150.00 




TSC Debug ^j wae $25.00 


Bam only 


420.00 


TSC Dlagnoet les 


a. J waa 


$75.00 


■sm 


only 


150.00 




TSC Text Processor T*tL. waa $25.00 


Bern ooly 


420.00 


TSC Utilities 


2>> "*■ 


$75.00 


Bam 


only 


150.00 
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(615)842- 



TILIX SSI 414 PVT ITH 

2-4600 M 

S900 Cassandra Smith Rd. 
Hixson. TN 37343 

(or information 
call (615) 842-4601 

CoCo OS-9" FLIX" 

SOFTWARE 




HSSEITIBLEHST 



ASTRUK09 fro* Southeast Media -- A "Structured Assembler for the 
6809" which requires the TSC Micro Asuattler. F, CCF - 199.9S 



Macro Assembler for TSC — The FLEX STABOAJto Assembler. 

Special •- CCF $35.00; 



F ISO. 00 



OSM Extended 6S0 Micro Assembler froa Llajd 1/0. — Provides local 
labels. Motorola S-records, and Intel Hex records; XREf. Gene- 
rate OS-9 Memory modules under FLEX. FLEX, CCF, OS-9 199.00 

Relocating Assembler w/L1nklna Loader from TSC. — Use *Un tuny of 
the C and Pascal Compilers. F.CCF $150.00 

KACB, by Graham Tron froa Vladruaa Micro Byeteaa — Co-Re«ldehC 
Editor and Aaaeabter; faat Interactive A.L. Prograauing for deall 
CO medlum-olied Progreae. F.CCF - S7S.00 

DUCT — MACE v/ Croaa Aauoabler for 6800/1/2/3/8 P.CCP - 598.00 

TRUE MOSS ASSEMBLERS froa Computer System Consultants -■ 
Support! 1802/5. 1-80, 6800/1/2/3/8/ll/HCU. 6804, 6BC5/HC05/ 
H6B05, 6809/00/01, 6502 flailly. B0B0/5, 8020/1/ 2/ 35/C35/39/ 
40/4B/C48/49/C49/6O/8748/49. 8031/51/8 751. and 68000 Systems. 
Aiietibler and Listing formats sane ts target CPU's format. 
Produces machine independent Motorola S-Teit. 

FLEX, CCF, OS-9, UnlFLEX each - 150.00 

any 3 - 1100.00 

the complete set «/ C Sotrc* (except Vie 68000 Source! - 1200.00 



XASM Cross Assemblers for FLEX froa Coaputeaxe Ltd. -- This set of 
6B00/1/2/3/S/8, 6301, 6S02, 8080/S, and 280 Cross Asseifclers 
uses the faafllar TSC Macro As stabler Commend line and Soruce 
Code format. Assembler options, etc., (n providing code for the 
target CPU's. Complete set, FLEX only - J1SO.O0 

CXASMI froa Lloyd 1/0 -- 8-Bit Macro Cross Assembler with same 
features as OSM; cross-assemble to 6800/1/2/3/4/5/8/9/11, 6502. 
1802, 8048 Sers, 80/8S, 2-8, 2-80, TMS-7000 sers. Supports the 
target chip's standard aneaooics and addressing nodes. 

FLEX, CCF, OS-9 Full package — 13*9.00 



CHASMS 16.32 from Lloyd I/O 



Cross Assembler for the 86000. 

FLEX, CCF, OS-9 1249.00 




DISBSSEmBLCHsTj 



SUPER SLEUTH froa Compete r Systems Consultant! — Interactive 
Disassembler; extremely POWERFUL! Olsk File Binary/ASCII 
f nanine /Change. Absolute or FULL Disassembly. XREF Generator, 
Label "Kane Changer", and Files of "Standard Label Karnes" for 
different Operating Systems 



Color Computer 

CCO (J2X Re<]'d) ObJ. Only $49.00 

CCF, ObJ. Only SSO.OO 

CCF, w/Source 199.00 

CCO, ObJ. Only SSO.OO. 



SS-SO Bus (all «/ A.L. 

f, sm.oo 
u, sioo.oo 

0, 1101.00 



DTRAMITE ♦ froie computer Systems Center — Excellent standard 
"Batch Mode" Disassembler. Includes XREF Generator and 
"Standard Label" Flies. Special OS-9 options w/ OS-9 Version. 

CCF, ObJ. Only 1100.00 CCO, ObJ. Only J Sf.fS 

F, ' * $100.00 0. • • 1150.00 

U. - 1300.06 



PHOGRHmminGlLflnGUHGESJ 



"FLEX is a i>a«JefT>a<* ol Technical Systems Consuilams 
"OS9 a, a lradcma/k c4 MKrowuo 



P1./9 froa atadraik Micro Syttena — By Crahaa Trocc. A eoablnatioo 
Editor /Compiler /Debugger. Olract eource-to-object compilation 
delivering faat. coapact, re-entrant, ROM-able, PIC. B 4 16-blt 
Integera 4 6-Hlglt Baal nunbere for all real-world problaaa. 
Direct control over ALL, Syatea raaourcaa. Including loterrupta. 
Comprehaoelvo library aupport; almple Machine Code Interlace; 
etep-by-etep tracer for loacant debugging. SdaH page ManuaL 
with tutorial guide. I. CCP - $1*8. Oa 

MK1MSICAI. from NMailcel Oawlooatnti - Hon supports Real Hassan. 
"Structured Programming" NITHOtlT losing the Speed and Control of 
Assembly Language! Single-pass emptier features unified, user- 
defined I/O; produces RONable Code; Procedures and Modules 
(including precompiled Modules); many "Types" up to 32 bit 
Integers, 6-dlalt Real Numbers, unlimited sized Arrays (vectors 
only); Interrupt handling; long Variable Names; Variable 
Initialization; Include directive; Conditional compiling; direct 
Code insertion; control of the Stack Pointer; etc. Hun-Time 
subroutines Inserted as called during compilation. Normally 
produces lot less code than PL/9. F and CCF - 1195.00 

C Compiler froa Wlndrash Micro Syssttas by Janes KcCosh. Full C for 
FLEX except bit-fields, including an Assembler. Requires the TSC 
Relocating Assembler if user desires to implement his own 
Libraries. F and CCF - 129S.0O 

C Compiler from Introl — Full C except Doubles and Bit Fields, 
streamlined for the 6809. Reliable Compiler; FAST, efficient 
Code. More UNIX Compatible than most. 

F. CCF, and - S37S.00 U - 1425.00 

PASCAL Compiler froa Ltiddate •- ISO Based P-Code Compiler. 
Designed especially for Microcomputer Systems. Allows linkage to 
Assembler Code For maximum flexibility. 

F and CCF S" - $190.00 F 8* - 120S.00 

Pascal. Compiler fron OaagaSafc (now Certified Sattanrm) — for the 

PBOrggBIOBiL; ISO Baaed, Native Code COapllar. Primarily for 

&>al-Tlae and Proceaa Control appUceclona. Powerful; Flexible. 

Require* a Motorola Compatible" Relo, Aamb. and Unking Loader. 

f and CCP - $42$. OB One Year Melnt. - $100.00 

(-BASIC froa LLOTO I/O — A "Native Code' BASIC Compiler which 1s 
now Filly TSC XBASIC coapatlble. The compiler coaplles to 
Assembly Language Source Code. A HEW, ttnaallMd. Assembler U 
now Included allowing the assembly of LARGE Compiled K-BASIC 
Programs. Conditional assembly reduces Run-tine package. 

FLEX, CCF, OS-9 Coaptler wit* Assembler - $199. 00 

CRUNCH COBOL froa Coamvimae Ltd. — Supports large subset of AHSII 
Level 1 COBOL with many of the useful level 2 features. Full 
FLEX File Structures, including Randoa Files and the ability to 
process Keyed Files. Segment and link large programs at 
runtime, or Implemented as a set of overlays. The Systea 
requires S6K and CAN be run with a single Oisk Systea. 

FLEX, CCF; Normally 1199.00 
Special Iitrmdmctary Prlca (while In effect) -- SW.H 

FORTH froa Steams Electronic! — A CoCo FORTH Programming 
Language. Tailored to tile CoCol Supplied on Tape, transferable 
to dllk. Written in FAST ML. Many CoCo functions (Graphics, 
Sound, etc.). Includes an Editor, Trace, etc. Provides CPU 
Carry Flag accessibility. Fast Task Multiplexing, Clean Interrupt 
Handling, etc. for the "Pro". Excellent "Learning" ool! 

Color Computer OflLT - SSB.fS 
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8aslc09 Ilcf from Southeast Media - This Bas1c09 Cross Reference 
Utility Is • 9*sic09 Prograa which will produce a 'pretty 
printed' listing with each line numbered, followed by • coaplete 
cross referenced listing of el) variables, external procedures, 
and line nuabers celled. Also Includes a Prejraa List utility 
which outputs • fast "prettgr printed" listing Kith line nuabers. 
Requires SasIcO? or RunB. 

t CCO obj. only -- JJ9.94; ■/ Source - 179.95 

lucldata PASCAL VTTLmia (toaalraa LDCIDATA Pascal var J) 

mr — produce a Croea Reference Uotlng of any text; orlvncid Co 

Paacal Source. 
IBCLVOR -- Include other Ftlel In a Source Text, Including Unary; 

unllalttd neactng capabllltlea. 
PROPILIR — provldea an Indented, Hunkered, "St ructograoT of a 

Paacal Source Text Pile; view the overall structure of larva 

prograse, prograa integrity, act. Supplied In Paacal Source 

Coda! raqulraa compilation, 

f, ccp — ua Dtuttr s- • s4o.oo, r - sjo.oo 

DUI fron Southeast Media -- A UnlFLEl 'basic* Oe-Coapiler. Re- 
create a Source Listing froa UntflEX Coaalled basic Prograas. 
Works «/ All Versions of MM UnlFLEX basic. U - IM.fS 

FULL SCIKE1 FORJB MSPUY froa Coaauter Syim Coasattuts — T5C 
Extended BASIC prograa supports any Serial Teralnat with Cursor 
Control or Neaory-Napped Video Displays; substantially extends 
the capabilities of the Prograa Designer by providing a tabic 
driven artAod of describing and using Full Screen Displays. 

P and CCP. U • "2*. 00. «/ Source - SM.00 



DISKjUTILITIES 



OS-l VDiie froa Southeast Ktdla — For L«r*l I only. Use the 
Extended Mesory capability of your SWTPC or Glolx CPU card (or 
slailer foraat SAT) for FAST Prograa Conplles. CMO execution, 
high speed Inter-process conauntcetions (without pipe buffers), 
etc. - SAVE that Systea Heaory. virtual Disk size is variable in 
«K increaents up to 960X. Soae Asieably Required. 
— Laval I 0M.T — OS-9 obj. only - J79.M; w/ Source - 1M9.9S 

0-F froa Soatbaaat Media — Written in IASICM («1tb Source), 
includes: REFORMAT, a IASIC09 Prograa that reroraats a chosen 
amount of an 01-9 disk to FLEi Foraat so It can be used normally 
by FLEX; and FLEI. a BASICOJ Prograa that does the actual road 
or arise function to the special 0-F Treaefer Mtk; user-friendly 
aenu driven. Read the FLU Directory, delete FLEX Files. Copy 
both directions, etc. FIEI users use the special disk just like 
any otMr FLEX disk. - S79.9S 

COPYrWlT froa Southeast Hedle -- Copy LAKE Disks to several 
•aallar disks. FLEX utilities allow the backup of AIT slae disk 
to any SMALLER site diskettes (Hard Disk to floppies, 8" to 5". 
etc.) by slnply inserting diskettes as requested by COfTNUT. 
xlo fooling with directory delettons. etc. COPTMIT.CKD 
understands noraal "copy" syntax and keeps up with files copied 
by aaintaining directories for both host and receiving disk 
systea. Also includes lACXUP.aea to download any site 'randoa* 
type file; RESTORE. Cm to restructure copied "rand oa" f iles ror 
copying, or recopying back to the host syttea; and F7Sn.naT.CpI) 
as a "bonus" utility that "relinks* the free chain of floppy or 
hard disk, eliminating fragaantetlon. 

Cexajletoty doceaaatad Aj trebly Laafaaaa Sear ca files laclaaad. 

ALL 4 Programs (FLEX. 8" or S") 191 .M 

COPYCAT froa Lucldate — Pascal DOT required. Allows reading TSC 
Nlni-FLEX. SSB D0S68, and Digital Research CP/H Disks while 
operating under FLEX 1.0. FLEX 2.0. or FLEX 9.0 with 6800 or 
6809 System. COPYCAT will not perfora alracles, but, between 
the program and the aanual, you stand a good chince of 
accoaplishing a transfer. Alto Includes soae utilities to help 
out. Prograas supplied in Modeler Soarce Codo (Asseably 
Language) to help solve unusual probleas. 

F and CCF S* - SW.OO F 8" - 145.00 
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tor Information 
call (815) 042-4001 

C0C0 OS-9" FLEX" 
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rui DLSI HTIL1TUB froa Ceaaartar lyaceaa •smltaata — light (I) 
different Aaaeably Language <«/ Source Code) PUX Utiiltloa for 
ovary PLIX Uaera Toolbox! Oafy a Pile with OK Brrere; T»ac IX ak 
for errori; Caaeara two OUka; a fait OLak laexa aj Prograa; Mtt 
blab Sectoral Uaaartae fraa-Ctaaia on th« olak; print tttak 
Idauttflcattsa; and tart and Replace Che Olak Directory (la 
aortad order). — PLOI — Ten XSA5IC PTOfraaa Including: A 
(ASIC laawtaaaacar with RXTIAa over -RR&urT like check for alaelng 
label daflnltlona, proceaaea mek to Wek loataad of to Heaory, 
ate. Other prograaa Caaaara, Merge, or Caaerata Ipdataa 
between two BASIC Progress, check BASIC Seaaajsco ttakari, 
cospere tea Bueeqaaecaw) fllaa. and 5 Prograas for establishing a 
baacar Diraccary of aevaral Oloka, and aortlng, aalectlng, 
updating, and printing paginated Uacingf of theae fllaa. A 
BASIC Crooa-gafaraaca Prograa, wrlctan in Aaaeably Language, 
which provldea an X-Kaf Llatlnx of t ho Varlablaa and kaaorvad 
Word. In T*C BA1IC, HACK, and naiXBPILD BASIC Prograaa. 

ALL UttUtlea laclaaa taal-ea (either BASIC or A.L. Source Code). 

P and CCP - S50.00 

BASK •tllttlM Can,! (or OkdFUZ — SM.00 
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CM0DEN Telecoaaanlcatioaa Prefraa froa Coapater Systeas 
Coatulttatt. lac. — "enu-Orlven; supports Ouab-Teralnal Kode, 
Upload and Download In non-protocol node, and the CP/M 'Mode*?' 
Chrlstensen protocol aode to enable coxnunication capabilities 
ror alaost any requlreecnt. Written in C. 

FLEX, CCF, OS-9, UnlFLEX; with coaplete Source • SUM, 00 

without Source • SSO.OO 

XOATA froa Soatheatt Madia -- A COMKVRICATIOI Package for the 
UbIFLEX Operating Systea. Use with CP/N, Main Friar l, other 
UnlFLEX Systeas, etc. Verifies Transalssion usin9 checksua or 
CRC: Re-Transalts bad blocks, etc. V - 12*9. H 



GHIT1E 



RAPIER - 6809 CbMJ Prograa froa Saatbeatt rbxrli — Requires FLEI 
end Olsplays on Any Type Ttrainal. Features: Four levfTs of 
play. Swap side. Point scoring systea. Two display boards. 
Change skill level. Solve Checkaate problens in l-?-3-4 aoves. 
Make nove and swap sides. Play white or black. This fs one of 
the ttroageit CHESS prograas running on any aicrocoaputer, 
estlaated USCF Rating 16D0* (better than aost 'club' players at 
higher levels). F and CCF - JT9.9S 
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SCREDITOR III from Ulsdrsik Micro Systems — Powerful Screen- 
Oriented Editor/Word Processor. Almost SO different commands; 
over 300 pages or Documentation with Tutorial. Features Multt- 
Cotumn display and editing, "decimal align' columns (AND add them 
up autoaa tlctlly), multiple keystroke macros, even/odd page 
headers and footers. Imbedded printer control codes, all 
justifications, 'help* support, store coaaon command serial on 
disk, etc. Use supplied "set-ups", or remap the keyboard to 
your needs. Etcept for proportional printing, this package will 
00 IT ALL! 

(600 or 6609 FLEX or 558 DOS, OS-9 - 1175.00 

8TTL0-GB4PB froa Great PUlia Coapator Co. — A full-ecroen 
orlaatsrf W0X0 PROCfSSOR — (iiui clw> 51 > 24 Dleplay Sc rases oa 
CoCo PLBX/STAR-OOS. or PIJ Wordpak). Pull acreeo dlaplay and 
sdltlng; supports the Delay Wheal proportional printers, 

— ) CCr and COO - 5**.»S, P or - $179.9$. - •JTx.93 



ITTLO-ffiLL froa Creak Plalae Comparer Co. — Pest Computer 

Dictionary. Coapleaama Stylograph, 
mn mam — > ccp and ceo - s*».»s, p or o - sw.es , v - ;u».«S 

inUHMCI froa Crest Plataa Cemaaater C*. — Merge Mailing Use to 
Torn" Letters, Print aultlple Piles, etc., through Stylo, 

— > CCr end CCO - J.S9.9S. P or O - S79VM, U - I1H.W 



JQ1T froa Soatheeet Medio -• Test Poraetter developed by Ron 
Anderson; for Dot Matrix Printers, provides many unique featuree. 
Output "Porasttad" TVxl to the Display. Ues the rpglirT.CNS 
supplied for producing aultlple coplee Of the "Formatted" Text On 
the Printer IHCLUOIKC lNliDDED PUaTU COrMAJM (very uaaful at 
other tlaea elao. end worth the price of the program by itself}. 
"User Coaflgurekle" for edeptlng to other Prlntere [coaes set up 
for Epeon NX-80 with Crsftras}} up to ten (10) Imbedded "Printer 
Control Commends". Coapaoeetsa for • "Double Width" printed line. 
Includes Che normal Una width, margin. Indent, paragraph, spsca, 
vertical aklp Unas, page length, page nuabarlng, cantering, fill, 
Justification, etc. Uss with Pal or any other editor. 

* Mow eupplled ae e two disk set: 
Disk II: JUST2.CW) object file. J0ST2.TXT PL9 aourca: TXML - CC 
Disk (1: JUSTSC Object and aoorcs In C: HJU - OSS' - CC 

The JTSC and regular JUST C eource arc two eeparata 
progrsas. JTSC compiles to a version thet expects TSC Word 
Processor type commands, (,pp .ep .ce etc.) Creet for your older 
test flies. 



The C source compiles to a standard syntax JVST.CHD 
object file. Uelog JD8T syntax (,p ,u ,y etc) with ell JUST 
funcclonn plus several eddltlonel printer formatting functlone. 
Reference the JD8TSC C source. For those wanting en excellent 
■UDG8T PilCBD word processor, with feeturee oooe of the othere 
have. This Is It I 

Disk (1) - PL9 PLEX Version Only - f 4 CCf - S49.9S 
Disk Set (2) - P A CCP A OS« (C version) - $89. 9S 

SPELLI 'Coaputer Dictionary" from Saathaast Media -- (WW 120,000 
•axdtl loot imy a ward froa within your Editor or Word Processor 
(with the SPH.CUD Utility which operates (n the Flti UCS). Or 
check and update the Text after entry; ADD WORDS to tiie 
Dictionary, "flag* questionable words In the Text, 'vies a word 
in context* before changing or Ignoring, etc. SPELLI first 
checks a "Coaaon Word Dictionary", then the noraal Dictionary, 
then a "Personal Word List*, and finally, any 'Special Word list' 
you may have specified. SRUIB also allows the use of Small Disk 
Storage systeeis. 

F and CCF - 1129. 9S 






XONS froa Westchester Applied lutlness Syitaas — Powerful OBMS; 

M.L. progra*. will work on a single tided S* disk, yet is F-A-S-T. 

Supports Relational, Sequential, Hierarchical, and Randoat Access 

File Structures; has Virtual Memory capabilities for Stint Data 

Bases. XDKS Lcoti j provides an 'entry level" Systea for defining 

> Data Base, entering and changing the Data, and producing 

Reports. XONS Level It adds the POWERFUL '6f.IKe.AlE - facility 

with an English Language Command Structure for manipulating the 

Data to create new File Structures, Sort, Select, Calculate, 

etc. XONS Leeel HI adds special "Utilities" which provide 

additional ease (n setting up a Data Base, such as copying old 

data Into new Data Structures, changing Systea Paraaeters. etc, 

XIM? Systea Haemal - ««.»s xnej 1*1 I - F t CCF - H29.9S 

XDKS 1*1 II - F 1 CCF - SL99.9S 

XONS 1*1 III - F * CCF - 1289.95 



AXXOWFTIo. PMXASfS -- Srmat Plalas Compwter Co. and Uktnrul Data 
"jotearck, lac. both have Data Base and Business Packages written 
In TSC -BASIC for FLEX, CoCo FLEX, and DniFLEX. 
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Add IX D.s.a. 

(•la. 11. M) 

xdd 5X Svffacs r»T»Un 

101 Mr -ercsea 
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TABULA RASA SPREADSHEET froa Computer Systems Csasaltaats -- 

TABULA RASA is similar to DESKTOP/PI AH; provides use of tabular 
coaputatlon schemes used for analysis of business, tales, and 
economic conditions. Menu-driven; extensive report-generation 
capabilities. Requires TSCs UCsedod BASIC. 

P tnd CCF, U - SSO.00. w/ Source - $100.08 

DTKACAIC froa Coaputer Systeas Ceater — Electronic Spread Siwet 
for the 6B09. 

F and SPECIAL CCF - 1200.00, U - 1*95.00 

FULL SCREE* IXTERTORtVUW from Compwter syttettt Coateltoets — Use 
the Full Screen Inventory Systea/Naterlali Requirement Planning 
for Maintaining Inventories. Keeps ttea field file (n 
alphabetical order for easier Inquiry. Locate and/or print 
records matching pertlal or complete Item, description, vendor, 
or attributes; find backorder or below stock levels. Print-outs 
In item or vendor order. MRP capability for the maintenance and 
analysis of Hierarchical assemblies of Items In the Inventory 
file. Requires TSCs Exceeded BASIC. 

r and CCF, U - SSO.OO, v/ Source - $100.00 

FULL SCIEEB MAILIIB LIST from Compwter Syitaas Coasaltaatt — The 
Full Screen Hailing List Systea provides a Beans of maintaining 
simple aailtng lists, locate all records matching on partial or 
coaplete naae, city, state, tip, or attributes for listings or 
Labels, etc. Requires TSC't External IASIC. 

P and CCF, V - $50.00, a/ Source - $100.00 

OIET-TRAC Forecaster from Southeast Media — An XBASIC program 
that plans a diet In terms of either calories and percentage of 
carbohydrates, proteins tnd fats (C P 61) or grams of 
Carbohydrate. Protein and Fat food exchanges of each of the six 
basic food groups [vegetable, bread, teat, slim milk, fruit tnd 
fat) for a specific Individual. Ses, Age, Height, Present Height, 
Fraae Size, Activity level and Basal Metabolic Rate for normal 
Individual are taken Into account. Ideal weight and sustaining 
calories for any weight of the above Individual are calculated. 
Provides number of days tnd dally calendar after weight goal and 
calorie plan 1s determined, 

F - Jjg.as. u - IH.K 
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near-UNIX. After a period, aoat learned chat what Che 
public really wanted waa performance! After alx aontha 
of effort and dozena of ayatema, the clear winner waa 
UnlFLEXI Since that time aeveral complex package 
handling ayateaa have been developed (although not with 
the "..overnight" people) and are working well. 
Ironically, two of the ayatema are sorting, tracking and 
palletizing A.T.&T. Peraonal Computers! 

In future artlclea I will describe UnlFLEX-d riven 
ayatema. their hardware configurations, tools, languages 
and applications packages. Alao, aa promised, I will 



describe the hardware bsse (Verss-Hodule European , 
VME) thst Is becoalng the most populsr configuration for 
M68XXX processing systems. I slso hsve some very 
powerful grsphlcs system Information for you and how to 
employ UnlFLEX as s development/ target environment for 
Me, 

I slso plsn to review ss many products as possible snd 
share with each of you the results. Whst I hsve decided 
to do Is provide s cursory review (of a particular 
product) here In the magazine, and if anyone la 
Interested In the details, write me st our business 
sddress. 
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"ISAM" 

INDEXED SEQUENTIAL ACCESS METHOD 

A File Implementation 

for 

FLEX9 Operating Systems 

By: Joseph D. Condon 8101 Alplns Drive Des Koines, lows 
50322 515 278-4581 

I. ISAM OVERVIEW 

ISAM Is s memory resident handler thst provides the 
user with Indexed sequentlsl file accessing methods. 
ISAM will allow multiple fllea to be open at the same 
time. The maximum number of open files Is limited only 
by the amount of memory dedicated to the handler at 
Installation time. ISAM allows sll record sizes In the 
range of 1 to 32767 chsrscters to be used, providing 
sufficient memory hss been si- locsted to the handler. 
The user need not be concerned with record sizes, 
blocking, snd wasted sector bytes when choosing s files 
record size. 1SAH records csn snd will extend scross 
disk sector boundaries, therefore all record sizes will 
be efficiently Implemented by ISAM. The maximum file 
alze aupported by ISAM la alao dependant upon the amount 
of memory dedicated to the handler at Installation time. 
A typlcsl ISAM handler Installation allowing two fllea 
to be open at the asme time, esch with s record size of 
up to 100 chsrscters, snd esch with s maximum file size 
of 1000 records, will require less thsn 8000 bytes of 
user memory. 

ISAM file sre unique In the senss thst they slwsys 
sppesr to be In s sorted sscendlng order dependent upon 
esch records content, Re- cords may be sdded to or 
deleted from the file In sny order. The ISAM handler 
will alwaya maintain the file In correct ascending 
order, The user may sccess the ISAM file In a sequentlsl 
manner either forwsrds or backwards. The user may 
slso specify the starting record for the sequentlsl 
sccssses to begin. The starting record msy bs specified 
aa being the first or last record In the ISAM file. The 
starting record may also be specified by the use of s 
starting record vslue. Thst Is the starting record will 
be the last record In the file whose content Is less 
thsn the specified starting record value. 

ISAM will provide the programer with a very 
powerfull tool which can be used to Implement 
sophisticated application programa and pack- ages. The 
ISAM handler Is written In sssembler lsngusge to ensure 
optimum speed, efflflency, snd memory utilization. 
Being sble to specify operating parameters st 
Installation time sllows the user to tailor ISAM to a 
specific systems requirements without hsvlng to wsste 
user memory. Although ISAM wss written with speed snd 
efficiency In mind, Its actual Implementation will be 
dependent upon the systems disk storage capabilities. 
ISAM will perform much quicker on s system equlpted with 
herd disk drives ss oppossed to one with only mini disk 
drives, snd even quicker on s system with RAH disk 
emulation. 



II. 



IMPLEMENTATION 



All communications with ISAM la accomplished 
through the use of s communication block. The format of 
the communication block la ldent- lcle to the format of 
a "TSC XBAS1C" string matrix. Thla allows essy use of 
ISAM with bsslc programa snd slso provides sn efficient 
mesns of communication with other programing lsnguages. 
The location of the communication block must be stored 
In memory location MEMEND-4 prior to calling ISAM. Upon 
completion of the command. ISAM will return s 16 bit 
unsigned numeric error code to the caller by storing the 
vslue st location MEMEND-4. The format of the 
communication block ss well ss esch elements description 
follows , 

ISAM UINMUN1CVTI0N BLOCK fORMAT 



Memory location x ♦ O IX X I X XI elament location 

x t 2 ! Y V I r Y I element length 
e-~ t— «■— -* — — ♦ 



x ♦ 4 IX XIX 
x I- 6 I » 
It ♦ 



element J location 



1 I Y Y I element I length 
4 1 ♦ + » 

9 IX XIX X ! element I location 
«.-- -♦—.-+— ♦— -f 

10 I X Y I Y Y t (lament 2 length 



a + 12 I X XIX XI elaaint 3 location 
> * 14 I r Y 1 Y Y ! eleasnt 1 length 



a ♦ 16 I X XIX XI element * location 

,. — e ► + ,. 

x ♦ l« I Y Y I Y Y t eleaent 4 length 



a ♦ 20 I X XIX XI alamant i location 
x ♦ 22 ! Y Y ! Y (I element 5 length 



ElEKeNT DESCRIPTIONS 



Clement ; FILE KUHBF.R 



Thle element muet have a length of two bytea and be 
in the form of a 16 bit unsigned numeric value. 



ELEKRNT 1 : ISAM COMMAND 



Thla element must have e length equal to or greater 
than two bytea. The flret two bytea of thle element 
ere used to define the ISAM command. 



ELEMENT 2 I PILE SPMlftCATlON 2 



Thle element auet be greater thsn and less then 256 
bytee In length. The element le need to conteln a 
etenderd "FLEX" file specification. 



ELEMENT J I RECORD SIZE 



This element muet hsve a length of two bytea snd be 
In the form of a !f> bit unsigned numeric value. 
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Thla element auet have a length of two bycee and b« 
tn che for* or 4 In blc unsigned numeric value. 



element i i record but res 



Thla eleaenc say 1m of any loflgch and la ueed Co 
paeo racord Information between ch* calling progrea 
and che ISAM hendler. 



The racord buffer araa (element 5), la 
element area that the ISAM handler will e 
ISAM will not change the elements location or 
will, whan a read command is requested 
requested recorda content* Into tha record bu 
If the record buffer area la not the asme le 
fllea record alxe, 1SAH will either truncal 
fill the racord contenta to fit the buffer 
uaer should always enaure that the length of 
buf- far element Is equal to or greater tha 
record six*. 



the only 

ver ax>d[fy. 

size but 

aove the 

ffer area. 

ngth as the 

or null 

area. The 

the record 

n the files 



III. 



1SAH COMMANDS 



ISAM command a are performed by first loading the 
communication block elcaenta with the approplate values, 
then storing the addraaa of the communlcet ton block at 
memory locstlon KKHKNO-4. The ISAM hsndler Is then 
called ss s subroutine vis the "JSR" or "BSR" 
instruction. Upon completion of the command, ISAM will 
alwsya store sn error code st memory locstlon MD1END-4, 
and then return to the calling program via the "RTS" 
Instruction. AIL of the above steps may be performed 
with one BASIC atatement uatng the "USR" function. The 
value returned to BASIC after execution of the "USR" 
function will be the ISAM error code. All error codea 
except for indicate an error was encountered by ISAM 
during tha execution of the last command. The following 
la a Hat of all ISAM commanda elong with a detailed 
description of their Individual functlona. 



PREVIOUS 1 Tha currant racord number aaaoclatad with tha f 1 La number 
■ ■i« ■! ■ i will ba decrameotsd by one. That record will Chen be read 

and returned Co Che cellar In Che coajmunlcadon block 
record buffer area. If the alia of che record La noc Che 
ease ■• Che aire of the record buffer araa, Che record 
Mill be CruneeCes or null filled accordingly. 

ADD : The record contained In Che record buffer area of Che 

— en— innlcaclon block will be added Co Che file number 

■pacified ec Che proper location according Co Che recorda 
concence. If Chla le Che flrec updace of Che file elnce 
open else. Che fltee header will be rewritten Indicating 
chec Che file la corrupt. II the slie of Che record la 
not Che in# aa Che else of Che record buffer area. Che 
record will ba truncated or null filled accordingly. 

DELETE . The current record number eseocleced wlch che file number 

Hlll D( de i ice< | ( roa ,h. fit., if chla la che flrec 

updete of che file elnce open else, che fllea header 
will be rewrlccen Indicating Chec Che flic le corrupc. 

REORGANIZE : Thla commend can only be executed on a file nuaber chet 
-— la currently open* Thla command le uied Co rebuild che 
fllea Index polncere end recelculece che fllee acCuel 
eUe. AfCer completion of chle command, che file will 
remain open end he ecceeeeble buC Che reorganized valuae 
will noc be written to che dink file untlll e cloae com- 
aand la executed by Che uaer. Thla commend may be uaad Co 
recover a corrupt file, chet le, e file chet hed bean up- 
dated end not properly cloeed efcerwerda. The UOKANIZE 
commend cen ba very time consuming end che uesr may wish 
Co conelder going to backup rather then reorgenlxtng che 
corrupted (lie. 

INITIALIZE - Thla command lnlclellzee che file nuaber epecifled tn die 
"*■■■ *" comaunlceclon block by ecceapclng to cloae che file epec- 
ifled In ice Incernal file control block. The open fleg 
eaeoclecad wlch che file number le chen marked ee being 
closed. Thla command may be required Co regeln eyncroo- 
txeclon wlch che TX.CX file aanegemenc eyetea efcer en- 
countering ,i dilate --ror. TMi r^emeM ihould he ueatf wlcb 
caution since It may cauee mn open file aaeoclaced 
wlch che file number Ci be cloeed with ice corrupClon 
fleg eec, requiring ch* file co be reorganized che nexc 
Cine 1C le opened. 



OPEN : The open command will acceapc Co open che file number 

— - IndlcaCed In che communication block uaLtzg Che file 

epectf lcetlone eupplled by Che caller. If the file epece 
do not Include e drive number, che ayacaaa working drive 
defaulc will be uaed. If che epece do noc contain e file 
extcnalon, che ISAM hendler will uee che exceneloo de- 
feuLC ol ''ISA". 

CLOSE : The close command will cloae che file nuaber lndlceCed. 

----- If Che file hee been updeced, Che close routine will 

rewrite che fllea heeder Information cleerlog che corrupc 
fleg end updeclng che fllee eccuel file elxe field, IC 
will eleo rewrite che files Index polncere. If che file 
has noc been updeced, che file will elaply be closed. 

CREATE : The creece command Is used Co build en empty ISAM file. 

The file nuaber ueed wlch chle command auac noc be cur- 
rently open. The ELle epeclf lcetlone will be handled 
Che name la In the OPEN command. The celler auoc eleo 
apeclfy che record elie end saxLsua file elze of che 
tSAN file Co be creeCed. Upon completion of Chle command, 
Che new file will be cloeed. 

PIRST : The currenc record number eseocleced wlch che file number 
will be eec Co polnc ac che ecerc of che file. 

LASI : The currenc record nuaber eeeoclaced with che file oiiaber 
will be eec Co polnc et che end of Che file. 

5TART : The currenc record number eeeoclaced wlch Che file nuaber 

■ ■ " will be eec Co polnc eC Che leec record In the file whoee 

concenc le lees chsn che acerctng record veLue epecifled 
to che record buffer eree of che comaunlceclon block. 

NEXT : The currenc record nuaber eeeoclaced wlch Che file number 

-■ — will be lncremenced by one. Thee record will Chen be read 

end returned Co Che celler In che coamuntcaclon block 
record buffer aree. If the elxe of the record le not che 
eemc ee che elxe of che record buffer eree, Che record 
will be crunceced or null filled eccordlngly. 

CVRkfhT : The currenc record nuaber asaoclated wlch che file number 

-w - will ba read and recurned Co Che caller In che record 

buffer eree of Che comaunlceclon block. If Che elxe of 
Che record le noc Che eeae ee Che elee of Clia record buf- 
fer eree, Che record will be crunceced or null filled 
accordingly. 



IV. INSTALLING ISAM 

Before uelng the ISAM handler. It must first be 
Installed In memory. The syntax of the Install commend 
Is "ISAM X.Y.Z", The X vslus specifies the maximum 
nuaber of ISAH fllea to be opened at any one time. The 
Y value Indicates the maximum record aize of any ISAH 
file that la to be opened or crested. The Z vslue is 
the maximum file sice of sny ISAM file thst will be 
opened or crested. All these psrsmcters must be greater 
thsn zsro snd contsln s positive vslus. ISAM uses the 
parameters to determine the amount of memory thst will 
be required by the ISAM hendler. ISAH then relocates 
Itself st the top of user memory end sdjusts the MEMEND 
locstlon to point to the memory location Just below 
ISAM. During lnstsllstlon time, ISAM will use 
approximately 4000 bytes of memory beginning st sddress 
$0000. Any progrsm currently st this locstlon will be 
overwritten. The following le s list of possible 
lnstsllstlon messages genersted by ISAM. All but the 
first message indicates thst ISAM hss not been installed 
in memory due to parameter errors or sn Insufficient 
amount of uaer memory. 

"ISAM INSTALLED AT LOCATION <ZJCU>" 

"INVALID MAXIMUM FII.ES" 
"INVALID MAXIMUM RECORD SIZE" 
"INVALID MAXIMUM PILE SIZE" 

"INSUFFICIENT AVAILABLE MEMORY" 

ISAM memory requirements will vsry greatly 
depending upon the lnstsllstlon parameters used. An 
approximation of required memory may be calculated using 
the following formula. 

MEMORY REQUIRED » I+X»(331+2«(Z))+2*Y 
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where I - ISAM handler size (appro* 3000). 
X - Maxlaua number of file*. 
Y - Maxlaua record alze. 
Z - Maxlaua file atze. 

Example: "ISAM 2,100,1000" 



MEMORY 

30O0+2«( 331+2* ( 1000) )+2* 100 



REQUIRED 

- 300O+2*(33l+2000)+200 

- 3000*2*2331+200 

- 3000+4662+200 
• 7862 



TOTAL USER MEMORY REQUIRED - 7662 BYTES 



ArTKNUU *, ISAM KKRIIR LH ■!».■. 

Tha following la ■ list of possible ISAM error codes which may be 
returned to ths calling program at memory location ruiMKND-*. Tha for- 
mat of thaaa codea ara 16 bit utialgned numeric values. 

ERROR CODE 1 COMMAND SUCCaSSPUL 

: Thla error coda Indicates that there vera no 
error! datactad by ISAM, 



ERIOt CODES 1-99 



Etxot cone loo 



CUM C001 iDi 



ERROR CO01 no 



EttOR CODE 



tlHl ERROR 
I Theae error codea may be Interpreted tha eama 
•• all stsiidsrd "KLEX" error codea. 

: IHVA1.1I> FILE NUMBER 

■ Thla error code Indicates that the calling 
program specified en Invalid (11a number. 

: INVALID COMMAND 

: Thla error code le returned to the caller 
whan an Invalid command waa attempted. 

: INVALID riLE SPSCIPICAT10K 
: Thla error coda Indlcatea that en Invalid 
rile specification was paaaed to ISAM in tha 

coaaunlcet Ion block. 



115 S INVALID VEtSIOM NUMBER 

: Thla error code will be returned If you at- 
tempt to open a file that doea not contain 
tha correct ISAM verelon number. 



EURO*. CODE 120 



ERROR COOK 



INVALID RECORD SUE 
I This error Indicates that an Invalid record 
else wee encountered by ISAM during an "OPEN*', 
"REORCINIZE" or "CREATE" command. Record alias 
must be positive and greater than cero. 

125 : KICORD SIZE TO LANCE 

t Thla error will be returned If en atteapt la 
asji. !•• itpeii ur create an ISAM Ills whose re- 
cord else le larger then that epeclfled at tha 
time ISAM wea installed In memory. 



ERROR cone: 110 



gtROR CODE 1)5 



ERROR O0OE l<0 



ttRO* ODD* 1*1 



1 INVALID flLK XlXK 

1 This error Incllcite* that en J.walld Ills 
site waa encountered by ISAM during an "OPEN", 

"RHURC1N1ZE" or "CREATE** command. Kile eltee 

must be positive and greater than zero. 

: MLE SIZE TO LANCE 

: Thle error will be returned If sn atteapt le 
made to open or create en ISAM file whose file 
else le lerger than that specified at the time 
ISAM waa luetelled In memory. 



1 ACTUAL ML* SUE > MAXIMUM 

: Thla error indlcatee that an open commend waa 
sttcaptad on e file whoee header Indicated 
thet the (Ilea actual length wee greater then 
the fllee maximum length. Thla error should 
never occur. 

i MAXIMUM SfcCTORS EXCl-IUJU) 

: The maximum else of a FLEX random acceea file 
le 65,5)5 eactora. If an attempt le made to 
Creole en ISAM file whose combination of rec- 
ord else and rile alta would create a randoa 
file greeter then 65,535 eectore, thle error 
code will be returned to the caller. 



ERROR CODE 150 



KsROA CODE 



ikkok coin; lto 



ERROR CODt 165 



EURO* CODE I TO 



ERROR CO0I 17 5 



1 CORRUPT flUL 

: Eech ISAM file header Mrtt contains a corrupt 
flag which Indicates the accuracy of tha files 
contents. If I hie (leg la set, all operations 
on the tile will return thle error, ascept for 
the "tlORCANIZE" end "CLOSE" commands. 

: ClUt MOT tM»*N 

: Thla error will be returned (or ell commands 
attempted on a file number which has not baan 
previously opened. 

I riLK IS OPEN 

i Thla error Indlcatea that e cellar attempted 
to open a file number that wee already open. 

1 START OP FILE 

An atteapt wea aade to read a record prior to 
the flret record of a file. 

1 END Or fILg 
An atteapt was aade to read a record beyond 
the last record of a file. 

; NULL RECORD 

i The caller attempted to edd a record that con- 
tained all null charactera to a ISAM file. 



ERROR CODE 1»0 : FILE PULL 

: An attempt wee made to add Bore recorda to a 
ISAM file that haa raeched lte aeslmum file 
else declared at craetlon t tae . 

APPENDIX g. BASIC PROCRAM EXAMPLE 

The following program la a baalc exaaple of how the 
ISAM handler la uaed. Although the prograa Is very 
functional. It la not Intended to be uaed for production 
type work. The prograa allows the uae of all ISAM 
coonvands at any time which Bay aceldently cause file 
corruption If not uaed correctly. Thla prograa la 
Intended to be uaed aa a pro- graalng example and 
nothing more. In order for the prograa to function 
properly, ISAM Bust have been previously lna tailed at 
memory location KEMEND+1, with a alnlaua record elie of 
100. The prograa will allow the uaer Co create and 
aalnceln a file coneleclng of addreaa labels In 
aacendlng alphabetical order according to the name 
field. 



10 REM «•«•«*« 

20 REM •••«* 

30 REM ***** 

40 REM ***** 

50 REM ••••••••••••••••«*••••••••*••«*«*«*«*•• 

60 REM 

70 DP0KE DFEEK(HEX("CC2*"))-2,0FEEK(HEX("CC2B" 

60 DIM A0S(S) 

90 A0S(0)-CVT2S(0) 

100 MS'" ■ 

110 A3S-" 

120 A4S-" 

130 ASS-" " 

140 AOS(5)-A2S+A3S+A4S+A5S 

150 PRINT 

160 PRINT " LABEL PROGRAM COMMANDS" 

170 PRINT "—————.— ........ •' 

160 PRINT "0PCN CLOSE CREATE" 

190 PRINT "FIRST 1AST START" 

200 PRINT "NEXT CURjtEKT PREVIOUS" 

DELETE 

LIST 



BASIC LABEL PROCRAM 



))+! 



RE0RGANIZI" 
INITIALIZE" 



210 PRINT "ADD 
220 PRINT "END 
230 PRINT '•————.————. 

240 PRINT 

2S0 INPUT "INTER COMMA" D" , A05 ( 1 ) 

260 G0SUB 320 

270 IP A03-0 GOTO ISO 

260 PRINT 

290 PRINT "ERROR CODE -",A03 

300 PRINT 

310 GOTO 150 

320 IP LEPTS(A0$(1),2)-"0F" GOTO 530 

330 IP LBFTS(A0S(1),2)-"CR" GOTO 500 

340 IP LBPr$(A0$(l).2)-"LI" GOTO 700 

350 IP LEPTS(A0S(1) ,2)-"ST" C0T0 550 
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COTO 550 
COTO 790 
COTO 790 
COTO 790 
COTO 870 
COTO 870 
COTO 870 
COTO 870 
COTO 870 
COTO 870 
THEM END 



360 IF LEPT$(A0$(1),2)-"AD' 

370 IK L£fT$(A0$(l),2)-"NI' 

380 IF LEFT$(A0$(1).Z)-"CU' 

390 IF LBFTS(A0S(1>,2>-"PR' 

400 IF LEFT$(A0$(1),2)-"IN' 

410 IF LEFTS(A0$(1).2)-"CL' 

420 IF LEPTS(A0$(1),2)-"FI' 

430 IF LKFT$(A0$(1) ,2)-"U' 

440 IF iem(A0$U).2)-"DE' 

450 IF LKFT$(A0$(1),2)-"RE' 

460 IF LEFT$(A0$(I),2)-"EN' 

470 PRINT "INVALID SELECTION" 

480 A03-0 

490 RETURN 

500 AO$(3)-CVT3$(IOO) 

510 INPUT "ENTER FILE SIZE",AI3 

520 A0$(4)-CVT3$(A13) 

530 INPUT "ENTER FILE SPECS", A0$(2) 

540 GOTO 870 

550 PRINT 

560 PRINT "NAME "; 

570 INPUT LINE AI$ 

580 LSET A2$«A1$ 

590 PRINT "STREET "; 

600 INPUT LINK Al$ 

610 LSET A3$-A1$ 

620 PRINT "CITY/STATE "; 

630 INPUT LINE Al$ 

640 LSET A4$-A1$ 

650 PRINT "2IP CODE "; 

660 INPUT LINE A1S 

670 LSET A5$-A1$ 

680 AO$(5)-A2$+A3$+A4$+A5$ 

690 COTO 870 

700 AO$(l)-"FIRST" 

710 C0SU8 870 

720 IF A03O0 THEN RETURN 

730 AOS(l)-"NEXT" 

740 GOSUB 790 

750 IP A03-0 COTO 740 

760 IF A03O170 THEN RETURN 

770 A03-0 

780 RETURN 

790 GOSUB 870 

800 IP A04O0 THEN RETURN 

810 PRINT 

820 PRINT NID$(A0S(5),1,30) 

830 PRINT KID$(A0$(5>.31,30) 

840 PRINT NID$(A0S(5>.6I,30) 

850 PRINT NID$(A0$(S).91,10) 

860 RETURN 

870 A04-USR(PTR(A0$(0))> 

880 RETURN 

Editor's Note: Due Co Che large size of Che actual 
aource code for Che above article, It will have to be 
published aa a aerlea. 

However, It say cake some 3 or 4 laauea to get It 
all In. Ic conalat of some 190 plus aectora of code. 
For thoae needed or desiring the complete source code 
NOW, I suggest you order It on the 68 Micro Journsl 
Resder Service Disk no. 23. As It will be available 
1 mediately. 

We also wish to thank Joeaph Condon for his generous 
offer to make this material svsllsbLe to our readers. 
It la Indeed a work of such labor and exhibits the 
depths of excellence available to all of ua by those 
willing to shsre. So Joe, I snd thousands of readera 
thank you for your klndneasl 

OKW 

P.S. Fleaae noce chat this Is copyrighted material. 
Should you desire to do something commercial or 
Involving money with It, pleaae contact the author for 
arrangoenta. 

ISAM Source Code Available on 68* Micro 
Reader Disk. See Ad on page 62 Disk #23. 



ISAM 



OPT pag 

TTL ISAM 

STTL INDEXED SEQUENTIAL ACCESS METHOD 
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DISCLAIMER 

J»E COIJOON MILL NOT ASSUME ANY 

RESPONSIBILITY FOR DADOES 1N- 

CURREO OR GENERATED BY THE USE 

OF THIS MATERIAL. 



aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 



PAG 

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 



ISAM CQMMANL) FORMAT 



<IN>IT]ALIZE - INITIALIZE ISAM HANOLER 



<0P>EN 

<CL>0$E 

<CR>EATE 

<FI>RST 

<LA>ST 

<ST>ART 

<:ne>xt 

<CU>R«ENT 
<PR>EVI0US 

<A0>D 



- OPfM ISAM FILE 

• CLOSE ISAM FILE 

- CREATE ISAM FILE 

- POINT TO FIRST RECORD 

■ POINT TO LAST RECORD 

- POINT TO SPECIFIED RECORD 

• READ NEXT RECORD 

■ READ CURRENT RECORD 

- READ PREVIOUS RECORD 

- ADO RECORD 



X <DE>ELETE » DELETE RECORD * 

* (REORGANIZE - REORGANIZE ISAM FILE X 

a » 

x * 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 



PAG 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

X * 

X FLEX EQUATES X 

X « 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 



VERNO 



EQU 



EOT 


EQU 


•84 


SPACE 


EQU 


•ze 


ORIGIN 


EQU 


• 8888 


WDRVNO 


EQU 


♦ CC8C 


MEMENO 


EQU 


•CC2B 


WARMS 


EQU 


• CD83 


PSTRNG 


EQU 


•CD IE 


PCRLF 


EQU 


•CO 2 4 


OUTADR 


EQU 


• C045 


INOEC 


EQU 


• C0«8 


FMS 


EQU 


«D484 



VERSION NUMBER 

ACS! I EOT CHARACTER 
ASCI I SPACE CHARACTER 

PROGRAM MEMORY LOCATION 
WORKING SR1VE NUMBER 
MEMORY ENO 
FLEX WARM ENTRY 
PRINT STRING ROUTINE 
PRINT CR e< LF 
PRINT HEX ADDRESS 
INPUT DECIMAL NUMBER 
FILE MANAGEMENT SYSTEM 
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« « 

I ISAM FCB STORAGE MAP X 

X X 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx«xxxxxxxxxxxxxxx 



0R0 



OF LAG 


RMB 


1 


CFLAG 


RMB 


1 


UFLAG 


RMB 


1 


RECSIZ 


RMB 


2 


MFSIZE 


RMB 


2 


AFSIZE 


RMB 


2 


CURREC 


RMB 


2 


1FCB 


RMB 


32B 


KEYTAB 







OPEN FLAG 
CORRUPT FLAG 
UPDATE FLAG 
RECORD SIZE VARIABLE 
MAX FILE SIZE TRIABLE 
ACTUAL FILE SIZE VARIABLE 
CURRENT RECORD NUMBER 
ISAM FILE CONTROL BLOCK 



PAG 
««X«X«««««>XXXXXX««««««>>>«««<«««««««««««>llllll*f<<« 
X X 



X INSTALL ISAM ROUTINE X 

X X 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 



PROGRAM ORIGIN 

BRANCH AROUND VERSION NO 
VERSION NUMBER 

PRINT CR fc LF 

GET INSTALL PARAMETERS 

PARAMETERS OK 

PRINT STRING 

PRINT CR t> LF 

RETURN TO FLEX 



INSTAL 



INS I 



1NS2 



ORO 


ORIGIN 


BRA 


1NS1 


FCB 


VERNO 


JSR 


PCRLF 


BSR 


GETPAR 


BEQ 


INS2 


JSR 


PSTRNG 


JSR 


PCRLF 


JMP 


WARMS 


LEAX 


IWSG8 


JSR 


PSTRNG 


LDD 


MEM END 


AODD 


It] 


PSH 


D 


LEAK 


8,S 


JSR 


OUTAOR 


PUL 


D 


JSR 


PCRLF 


JMP 


WARMS 



INMSG8.PCR POINT TO MESSAGE 
PRINT STRING 
GET MEMORY END VALUE 
INCREMENT VALUE 
SAVE D REO ON STACK 
POINT TO VALUE ON STACK 
OUTPUT ADDRESS 
RESTORE STACK 
PRINT CR fc LF 
RETURN TO FLEX 



INSUFFICIENT MEMORY 
R ADD RECORD BUFFER 
INSUFFICIENT MEMORY 
STORE TEMPORARY 
POINT TO END OF HANDLER 
CALCULATE HANDLER LENGTH 
ADD BUFFER SIZE 
INSUFFICIENT MEMORY 
COMPARE TO AVAILABLE MEMORY 
INSUFFICIENT MEMORY 
STORE TEMPORARY 
GET MEMEND VALUE 
SUBTRACT ISAM SIZE 
ADJUST LOCATION 
STORE TEMPORARY 
COUNT, PCR POINT TO END OF HANDLER 
TEST FOR OVERLAP 
INSUFFICIENT MEMORY 
SAVE ISAM END 
POINT TO START OF HANDLER 
POINT TO NEW LOCATION 

0P2 LDA 8,X* GET ISAM BYTE 

STORE ISAM BYTE 
TEST FOR HANDLER END 
MOVE NEXT BYTE 

CLR 8,Y< CLEAR BUFFER BYTE 

TEST FOR BUFFER END 
CLEAR NEXT BYTE 
GET ISAM LOCATION 
GET NEW MEMEND 
SET NEW MEMEND 
GET STATUS CODE 
RETURN 



X INSTALL ERROR ROUTINE 

1NERRI LEAX INMSG1.PCR POINT TO MESSAGE 

RTS RETURN 

INERR2 LEAX INMSG2.PCR POINT TO MESSAGE 

RTS RETURN 

INERR3 LEAX INMSQ3,PCR POINT TO MESSAGE 

RTS RETURN 

INERR4 LEAX 1NMSG4.PCR POINT TO MESSAGE 

RTS RETURN 



BCS 


INERR4 


AOOD 


l NPAR2 , PI 


BCS 


INERR4 


STD 


-2.S 


LDD 


K BUFFER 


SUBD 


WISAM 


ADDD 


-2.S 


BCS 


INERR4 


CMPD 


MEMEND 


BH1 


INERR4 


STO 


-2,S 


LDD 


MEMEND 


SUBD 


-2,S 


ADDO 


Ml 


STO 


-2,S 


LEAX 


COUNT, PCI 


CMPX 


-2,S 


BHS 


INERR4 


STX 


-4,S 


LEAX 


I SAM, PCR 


LOY 


-2,S 


LDA 


8,X* 


STA 


e,Y« 


CMPX 


-4,S 


BLO 


GP2 


CLR 


8,Y< 


CJ1PY 


MEMEND 


BLE 


GP3 


LDO 


-2,S 


SUBD 


Nt 


STO 


MEMENO 


LOX 


*9 


RTS 





GET INSTALL PARAMETERS 



INSTALL MESSAGES 



GETPAR 



JSR 

LBCS 

TFR 

LBEO 

LBMI 

STD 



OP I 



JSR 

LBCS 

TFR 

LBEO 

LBMI 

STD 

JSR 

LBCS 

TFR 

LBEO 

BMI 

STO 

LSLB 

ROLA 

BCS 

ADDD 

BCS 

STD 

LOX 

LDD 

ADDD 

BCS 

LEAX 

BNE 

AOOD 



INDEC INPUT DECIMAL NUMBER 
INERR1 INUALID FILE NUMBER 
X,D MOVE X REG TO D REG 
INERR] INVALID FILE NUMBER 
INERRI INVALID FILE NUMBER 
INPARl ,PCR STORE INPUT PARAM I 

INDEC INPUT DECIMAL NUMBER 
INERR2 INVALID RECORD SIZE 
x,0 MOVE X REO TO D REG 
INERR2 INVALID RECORD SIZE 
INERR2 INVALID RECORD SIZE 
INPAR2.PCR STORE INPUT PARAM 2 

INOEC INPUT DECIMAL NUMBER 
1NERR3 INVALID FILE SIZE 
X,D MOVE X REG TO D BEG 
1NERR3 INVALID FILE SIZE 
1NERR3 INVALID FILE SIZE 
1NPAR3.PCR STORE INPUT PARAI1 3 

MULTIPLY D REG TIMES 2 



INERR4 INSUFFICIENT MEMORY 
•KEYTAB ADD ISAM HEADER LENGTH 
INERR4 INSUFFICIENT MEMORY 
-2,S STORE TEMPORARY 
INPARl, PCR GET INPUT PARAM I 
MB CLEAR • REG 

-2,S ADO ISAM FILE AREA 
1NERR4 INSUFFICIENT MEMORY 
-l,X DECREMENT FILE NUMBER 
GPl ADD NEXT FILE AREA 
INPAR2.PCR ADO RECORD BUFFER 



1NMSG0 FCC 'ISAM INSTALLED AT LOCATION .EOT 

INMSGI FCC 'INVALID MAXIMUM FILES', EOT 

INMSG2 FCC 'INVALID MAXIMUM RECORD SIZE '.EOT 

1NMS03 FCC 'INVALID MAXIMUM FILE SIZE', EOT 

INMSG4 FCC 'INSUFFICIENT AVAILABLE MEMORY', EOT 



PAG 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

X X 

X ISAM MAIN ENTRY POINT > 

X X 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 



ISAM LOY MEMENO GET FLEX MEMEND VALUE 

LOY -4,Y POINT TO CALLER IFCB 

STY CIFPNT.PCR STORE CALLER IFCB POINTER 

BSR DECODE DECODE AND EXECUTE COMMAND 

LOY MEMEND GET FLEX MEMENO VALUE 

STD -4,Y STORE STATUS CODE 

RTS RETURN TO CALLER 



xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 

X X 

* DECODE AND EXECUTE COMMAND SUBROUTINE * 
X X 

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 



DECODE LEAY 8,Y GET CALLER FILE NUMBER 

LOD 2,Y GET FILE NUMBER LENGTH 

CMPD *2 TEST FILE NUMBER LENGTH 

L9NE ERR168 INVALID FILE NUMBER 

LOD I8,Y] GET FILE NUMBER 

ADDD H] ADJUST TO ONE SIGNIFICANT 

CMPD INPARl, PCR COMPARE TO MAX FILES PARAM 

LBHI ERRIBB INVALID FILE NUMBER 
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SUBD 

STD 

LDD 

LSLB 

ROLA 

ADOD 

STO 

LBSR 

LOO 

AODD 

AOOD 

LEAU 

STU 

ADDD 

TFR 

LOY 

LEAY 

LDO 

CMPD 

LBLO 

LDD 

OIPD 

BEO 

OIPD 

BEQ 

O1P0 

LBEQ 

OIPD 

LBEO 

OIPO 

LBEO 

O1P0 

LBEO 

CMPO 

LBEO 

CMPO 

LBEO 

CMPO 

LBEO 

OIPD 

LBEQ 

O1P0 

LBEO 

CMPO 

LBEO 

CMPD 

LBEQ 

LBRA 



«1 ADJUST FOR ZERO SlSNlFlCANr 

ACCLMl.PCR STORE IN ACCUM I 
INPAR3.PCR GET MAX FILE SIZE PARAM 
MULTIPLY BY TWO 

tfKEYTAB ADO FILE HEADER LENGTH 

ACCUM2.PCR STORE IN ACCUM 2 

MUL32 MULTIPLY ACCUM I BY ACCUM 2 

ACCUM3+2.PCR GET PRODUCT 

INPAR2.PCR ADD MAX RECORD SIZE PARAM 

INPAR2.PCR ADD MAX RECORD SI2E PARAM 

BUFFER, PCR GET BUFFER LOCATION 

-2,S STORE TEMPORY 

-2,S ADD TEMP TO REG 

0,U TRANSFER REG TO U REG 

CIFPNT.PCR GET CALLER ISAM FCB PNTR 
4.Y POINT TO COMMAND OESC 
2,Y GET ISAM COMMAND LENGTH 
«*2 TEST COMMAND STRING LENGTH 
ERR18S 1NUALIO COMMAND 
18, YJ GET ISAM COMMAND 

N*494E INITIALIZE ISAM HANDLER 

INIT EXECUTE SUBROUTINE 

H«4F38 OPEN ISAM FILE 

OPEN EXECUTE SUBROUTINE 

H«434C CLOSE ISAM FILE 

CLOSE EXECUTE SUBROUTINE 

H*43S2 CREATE ISAM FILE 

CREATE EXECUTE SUBROUTINE 

H*4£49 POINT TO FIRST RECORD 

FIRST EXECUTE SUBROUTINE 

M*4C4I POINT TO LAST RECORD 

LAST EXECUTE SUBROUTINE 

K»3334 POINT TO SPECIFIED RECORD 

START EXECUTE SUBROUTINE 

MS4E43 READ NEXT RECORD 

NEXT EXECUTE SUBROUTINE 

•(•4333 READ CURRENT RECORD 

CURRNT EXECUTE SUBROUTINE 

»«S8S2 READ PREVIOUS RECORD 

PREV EXECUTE SUBROUTINE 

««4144 ADD RECORD 

ADO EXECUTE SUBROUTINE 

MV4443 DELETE RECORD 

DELETE EXECUTE SUBROUTINE 

■•5243 REORGANIZE ISAM FILE 

REORG EXLLUIL iUbHOUIINt 

ERR183 INVALID COMMAND 



OPEN I 



LOA 
STA 
LEAY 

JSR 

LBNE 

CMPA 

LBNE 

DEC 

BNE 

JSR 
LBNE 
STA 
JSR 

LBNE 

ORA 

STA 

JSR 

LBNE 

STA 

JSR 

LBNE 

STA 

LOO 

LBEO 

CMPO 

LBHI 

JSR 

LBNE 

STA 

JSR 

LBNE 

STA 

LDO 

LBEO 

CMPO 

LBHI 

LBSR 
LBNE 

JSR 

LBNE 

STA 

JSR 

LBNE 

STA 

LOO 

CMPO 

LBHI 



MB ISAM FILE VERSION LENGTH 
COUNT, PCR SET LENGTH COUNTER 
lFVER.PCR POINT TO ISAM FILE VERSION 

FMS READ NEXT CHAR 

FMSERR GOTO FMS ERROR 

8,Y« COMPARE VERSION CHAR 

ERR I IS GOTO VERSION 

COUNT, PCR DECREMENT LENGTH COUNTER 

OPEN I READ NEXT ClIAR 



FMS 

FMSERR 
CFLAG.U 
FMS 

FMSERR 

CFLAG.U 

CFLAG.U 

FMS 

FMSERR 
RECSIZ ,U 
FMS 
FMSERR 
RECSIZ ♦ t 
RECSIZ, L 
ERR 1 28 
INPAR2, 
ERR I 23 



READ NEXT BYTE 
GOTO FMS ERROR 
STORE CORRUPT FLAG 
READ NEXT BYTE 

GOTO FMS ERROR 

OR WITH CORRUPT FLAG 

STORE CORRUPT FLAG 

READ NEXT BYTE 

GOTO FMS ERROR 
U STORE RECORD SIZE UP 

READ NEXT BYTE 

GOTO FMS ERROR 
t.U STORE RECORD SIZE LOW 
U GET RECORD SIZE 

INVALID RECORD SIZE 
PCR COMPARE TO REC SIZE PARAM 

RECORD SIZE TO LARGE 



FMS READ NEXT BYTE 

FMSERR GOTO FMS ERROR 

MFSIZE.U STORE MAX FILE SIZE UP 

FMS READ NEXT BYTE 

FMSERR GOTO FMS ERROR 

MFSIZE. l,U STORE MAX FILE SIZE LOW 

MFSIZE.U GET MAX FILE SIZE 

ERR 1 38 INVALID MAX FILE SIZE 

INPAR3.PCR COMPARE TO FILE SIZE PARAM 

ERRI33 FILE SIZE TO LARGE 



CSCOFF 
EXIT 



CALCULATE FCB OFFSETS 
EXIT WITH ERROR 



FMS READ NEXT BYTE 

FMSERR GOTO FMS ERROR 

AFSIZE.U STORE ACTUAL FILE SIZE UP 

FMS READ NEXT BYTE 

FHSERR GOTO FMS ERROR 

AFSIZEtl.U STORE ACTUAL FILE SIZE LOW 

AFSIZE.U GET ACTlftL FILE SIZE 

MFSIZE.U COMPARE TO MAX FILE SIZE 

ERRI48 ACTUAL FILE SIZE > MAX 



XXXXX XXXXXXX XXXXXXXX xxxxxxxx 

> X 

X ISAM INITIALIZE ROUTINE , 

> X 
XXXXXXXX XXXXXXXXXX XXX XX xxxxxx 



INIT LEAX IFCB.U POINT TO ISAM FCB 

LOA »«84 ' GET FILE CLOSE CODE 

STA 8.X SET FCB FUNCTION CODE 

JSR FMS CALL FMS 

CLR OFLAG.U CLEAR OPEN FLAG 

LDD «6 CLEAR STATUS CODE 

RTS RETURN 



««*«« * XX X XX X XX XXX 

« I 

X ISAM OPEN ROUTINE X 
> X 
XXXXXXXXXXXXXXXXXXXXXIXXXX XX xxxx 



KEYTAB, U GET KEY TABLE LOCATION 
MFSIZE.U GET MAX FILE SIZE 
COUNT, PCR STORE RECORD COUNT 



OPEN 



TST 


OFLAG.U 


LBNE 


ERR J 68 


LBSR 


QETFIO 


LBNE 


EXIT 


l£ X 


IFCB.U 
»»6 3 


STA 


e T x 


JSR 


FMS 


LBNE 


FMSERR 


LOA 


»«82 


STA 


23.X 


LDA 


M*FF 


STA 


39,X 



TEST OPEN FLAG 
FILE IS OPEN 
GET FILE SPECS 
EXIT WITH ERROR 

POINT TO FCB 

GET OPEN FOR WRITE CODE 

SET FCB FUNCTION 

CALL FMS 

GOTO FMS ERROR 

RANDOM FILE SECTOR naP CODE 
SET FILE SECTOR MAP IND 
NO SPACE COMPRESSION COOE 
SET SPACE COMPRESS] ON FLAG 



LEAY 

LDO 

STO 

0PEN2 JSR 
LBNE 
STA 
JSR 
LBNE 
STA 
LDO 
SUBO 
STO 
BNE 

LOO 

STD 

INC 

CLR 

TST 

LBNE 

LOO 

RTS 



XXXXXIIXIXXXIXXXXXIXXXXXIIXXXXXIXXIXXXIXXXXXIXXIXXII 
X X 

X ISAM CLOSE ROUTINE I 

X X 

XXXXXXXXXIIXXXXXXXXXXXXXXXIIXXXXXXXXXXXXXXXIIIXXXXXX 



CLOSE TST OFLAG.U TEST OPEN FLAG 

LBEO ERR135 FILE NOT OPEN 

LEAX IFCB.U POINT TO ISAM FCB 

TST CFLAO.U TEST CORRUPT FLAG 

LBNE CL0SE2 CLOSE FILE 

TST UFLAG.U TEST UPDATE FLAG 

LBEO CL0SE2 CLOSE FILE 



FMS 


READ NEXT BYTE 


FMSERR 


GOTO FMS ERROR 


e.Y. 


STORE BYTE IN KEYTAB 


FMS 


READ NEXT BYTE 


FMSERR 


GOTO FMS ERROR 


8,Y« 


STORE BYTE IN KEYTAB 


COUNT , PCR 


GET RECORD COUNT 


Bl 


DECREMENT RECORD COUNT 


COUNT, PCR 


STORE RECORD COUNT 


0PEN2 


GET NEXT RECORD POINTER 


M 


POINT TO START OF FILE 


CURREC.U 


SET CURRENT RECORD POINTER 


OF LAO, U 


SET OPEN FLAG 


UFLAO.U 


CLEAR UPtATE FLAG 


CfLAG.U 


TEST CORRUPT FLAG 


ERR 139 


CORRUPT FILE 


N» 


CLEAR STATUS CODE 




RETURN 
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CLOSE I 



LOO 

STO 

LDA 

STA 

JSR 

LBNE 

LDA 

STA 

LDA 

STA 

CLRA 

JSR 

LBNE 

INC 

CLRA 

JSR 

LBNE 

LDA 
STA 

LDA 

JSR 

LBNE 

INC 

LOO 

JSR 

LBNE 

INC 

LOO 
STO 
LEAY 

LDA 

JSR 

LBNE 

INC 

LDA 

JSR 

LBNE 

LOO 
SUBO 
STO 
BEG 

INC 
BNE 

LOO 

AOOO 

STO 

LDA 

STA 

JSR 

LBNE 

LDA 

STA 

LDA 

1*2 

LDA 

STA 

JSR 

LBNE 

CLR 

LOO 

RTS 



#1 GET FIRST RELATIVE RECORD 

32 ,X SET FCB REL RECORD 

#»I3 GET FMS POSITION CODE 

9,X SET FCB FUNCTION CODE 

FMS POSITION TO RECORD N 

FM8ERR GOTO FMS ERROR 

#«I2 GET FMS PUT RANDOM CODE 

8,X SET FCB FUNCTION CODE 

#12 GET FIRST BYTE OFFSET 

35.X SET FCB BYTE OFFSET 

CLEAR A REGISTER 

FMS PUT RANOOM BYTE 

FMSERR GOTO FMS ERROR 

33,X BUMP FCB BYTE OFFSET 

CLEAR A REGISTER 

FMS PUT RANOOM BYTE 

FMSERR GOTO FMS ERROR 

XIS GET FIRST BYTE OFFSET 

33.X SET FCB BYTE OFFSET 

AFSIZE.U GET ACTUAL FILE SUE UP 

FMS PUT RANOOM BYTE 

FMSERR GOTO FMS ERROR 

33 .X BUMP FCB BYTE OFFSET 

AFSIZEM.U GET ACTUAL FILE SIZE LOW 

FMS PUT RANOOM BYTE 

FMSERR GOTO FMS ERROR 

33, X BUMP FCB BYTE OFFSET 

MFSIZE.U GET MAX FILE SIZE 
COUNT, PCR SET RECORD COUNT 

KEYTAB.U POINT TO KEY TABLE 

B,Y» GET KEY TABLE BYTE 

FMS PUT RANOOM BYTE 

FMSERR GOTO FMS ERROR 

33.X BUMP FCB BYTE OFFSET 

8,Y« G T KEY TABLE BYTE 

FMS PUT RANOOM BYTE 

FMSERR SOTO FMS ERROR 

COUNT, PCR GET RECORD COUNT 

#1 DECREMENT RECORD COUNT 

COUNT, PCR STORE RECORD COUNT 

CL0SE2 CLOSE FILE 

33, X BUMP FCB BYTE OFFSET 

CLOSEI WRITE NEXT POINTER 

32, X GET REL RECORD NUMBER 

HI BUMP RECORD NUMBER 

32, X SET REL RECORD NUMBER 

#•13 GET FMS POSITION CODE 

B.X SET FCB FUNCTION CODE 

FMS POSITION TO RECORD N 

FMSERR GOTO FMS ERROR 

#•12 GET FMS PUT RANOOM CODE 

6,X SET FCB FUNCTION CODE 

#4 GET FIRST BYTE OFFSET 

33.X SET FCB BYTE OFFSET 

CLOSE! WRITE NEXT POINTER 

#•84 GET CLOSE CODE 

8,X SET FCB FUNCTION 

FMS CLOSE FILE 

FMSERR GOTO FMS ERROR 

OFLAG.U CLEAR OPEN FLAG 

#8 CLEAR STATUS CODE 
RETURN 



CRI 



CR2 



CR3 



CR5 



■ IIIKIIIIIIKIIIKIIIIIIIIKIHKHIIIIHIIIIIKIII 

* « 

X ISAM CREATE ROUTINE X 

X X 

XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX<XXXXXXXXXXXXXXXXXX 



CREATE 



TST 


OFLAG, 


LBNE 


ERR 148 


LBSR 


GETFJO 


LBNE 


EXIT 


LOY 


CIFPNT 


LEAY 


12. Y 


LOO 


2,Y 


CMPO 


#2 


LBNE 


ERRI28 


LOD 


ce.Yj 


LBEO 


ERR 126 


CMPO 


INPAR2 


LBHt 


ERR 123 


STO 


RECSIZ 



U TEST OPEN FLAG 
FILE IS OPEN 
GET FILE SPECS 
EXIT WITH ERROR 

,PCR GET CALLER ISAM FCB PNTR 
POINT TO RECORD SIZE OESC 
GET RECORD SIZE L NGTH 
TEST FOR PROPER FORMAT 
INVALID RECORD SIZE 
GET RECORD SIZE 
INVALID RECORD SIZE 

,PCR COMPARE TO REC SIZE PARAM 
KECORO SIZE TO LARGE 

,U SET RECORD SIZE VARIABLE 



LOY 

LEAY 

LOO 

CMPO 

LBNE 

LOO 

LBEO 

CMPO 

LBHI 

STO 

LBSR 
LBNE 

LEAX 

LDA 

STA 

JSR 

LBNE 

LDA 
STA 
LDA 
STA 

LDA 
STA 

CLRA 

JSR 

LBNE 

DEC 

BNE 

LOO 
STO 

LDO 

JSR 

LBNE 

LOD 

TFR 

JSR 

LBNE 

LOO 

AOOD 

STO 

CMPO 

BNE 

LOY 

STY 

LOY 
BEO 

LEAY 

STY 
LOY 

CLRA 

JSR 

LBNE 

LEAY 

BNE 

BRA 

LDA 
STA 
JSR 

LBNE 

LDA 
STA 
JSR 
LBNE 

LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LDA 
STA 
LEAY 

LDA 

JSR 

LBNE 

INC 

DEC 

BNE 



CIFPNT.PCR GET CALLER ISAM FCB PNTR 

16, Y POINT TO MAX FILE SIZE OESC 

2.Y GET MAX FILE SIZE LENGTH 

#2 TEST FOR PROPER FORMAT 

ERRI3B 1NUAL1* MAX FILE SIZE 

I8.Y] GET MAX FILE SIZE 

ERRI3B INVALID MAX FILE SIZE 
INPAR3.PCR COMPARE TO FILE SIZE PARAM 

ERR 1 33 FILE SIZE TO LARGE 

MFS1ZE.U SET MaX FILE SIZE VARIABLE 

CSCOFF CALC SECTOR CHAR OFFSET 

EXIT EXIT WITH ERROR 

IFCB.U POINT TO ISAM FCB 

#•82 GET OPEN FOR WRITE CODE 

8,X SET FCB FUNCTION 

FMS CALL FMS 

FMSERR GOTO FMS ERROR 

#»B2 RANDOM FILE SECTOR MAP CODE 

23, X SET FILE SECTOR MAP INO 

»»FF NO SPACE COMPRESSION CODE 

39, X SET SPACE COMPRESSION FLAG 

#1<S GET ISAM FILE HEADER LENGTH 

COUNT, PCR SET LENGTH COUNTER 

GET NULL CODE 

FMS CALL FMS 

FMSERR GOTO FMS ERROR 

COUNT, PCR DECREMENT LENGTH COUNTER 

CRI GET NEXT CHAR 

#8 GET RECORD COUNTER 

COUNT, PCR SET RECORD COUNTER 

COUNT, PCR GET RECORD COUNTER 

FMS WRITE RECORD COUNTER UPPER 

FMSERR GOTO FMS ERROR 

COUNT, PCR GET RECORD COUNTER 

B,A GET RECORD COUNTER LOWER 

FMS WRITE RECORD COUNTER LONER 

FMSERR GOTO FMS ERROR 

COUNT, PCR GET RECORD COUNTER 

•1 INCREMENT RECORD COUNTER 

COUNT, PCR STORE RECORD COUNTER 

MFSIZE.U TEST FOR LAST RECORD 

CR2 WRITE NEXT POINTER 

MFS1ZE.U GET MAX FILE SIZE VARIABLE 

COUNT, PCR SET COUNTER 

COUNT, PCR GET FILE SIZE COUNTER 

CR5 DATA FILE CREATED 

- 1 ,¥ DECREMENT FILE SIZE 
COUNT, PCR STORE FILE SIZE COUNTER 

RECSIZ, U GET RECORD SIZE VARIABLE 

CLEAR A REGISTER 

FMS WRITE NEXT CHARACTER 

FMSERR GOTO FMS ERROR 

-I,Y DECREMENT RECORD SIZE 

CR4 WRITE NEXT CHARACTER 

CR3 WRITE NEXT RECORD 

#•94 GET CLOSE CODE 

8,X SET FLB FUNCTION 

FMS CALL FMS 

FMSERR GOTO FMS ERROR 

#•83 GET OPEN FOR UPOATE CODE 

6,X SET FCB FtNCTION 

FMS CALL FMS 

FMSERR GOTO FMS ERROR 

#•12 GET PUT RANOOM BYTE CODE 

B,X SET FCB FUNCTION 

#•82 RANDOM FILE SECTOR MAP CODE 

23 ,X SET FILE SECTOR MAP INO 

»»FF NO SPACE COMPRESSION CODE 

59, X SET SPACE COMPRESSION FLAG 

#4 GET FIRST BYTE OFFSET 

33, X SET FCB RANDOM INDEX 

#B ISAM FILE VERSION LENGTH 

COUNT, PCR SET LENGTH COUNTER 

[FVER.PCR POINT TO ISAM FILE VERSION 

S,Y« GET VERSION CHAR 

FMS CALL FMS 

FMSERR GOTO FMS ERROR 

33, X BUMP FCB RANDOM INDEX 

COUNT, PCR DECREMENT LENGTH COUNTER 

CR6 GET NEXT CHAR 
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GET FLAG VALUE UPPER 
WRITE FLAG VALUE UPPER 

GOTO FMS ERROR 

BUMP FCB RANDOM INDEX 

GET FLAG VALUE LOWER 

WRITE FLAO VALUE LOWER 

GOTO FMS ERROR 

BUMP FCB RANDOM INDEX 

GET RECORD SIZE VARIABLE 

WRITE RECORD SIZE UPPER 

GOTO FMS ERROR 

BUMP FCB RANDOM INDEX 

GET RECORD SIZE VARIABLE 

GET RECORD SIZE LOWER 

WRITE RECORD SIZE LOWER 

GOTO FMS ERROR 

BUMP FCB RANDOM INDEX 

GET MAX FILE SIZE VARIABLE 

WRITE FILE SIZE UPPER 

GOTO FMS ERROR 

BUMP FCB RANDOM INDEX 

GET MAX FILE SIZE VARIABLE 

GET FILE SIZE LOWER 

WRITE FILE SIZE LOWER 

GOTO FMS ERROR 

BUMP FCB RANDOM INDEX 

GET ACTUAL FILE SIZE UPPER 

WRITE ACTUAL FILE SIZE UP 

GOTO FMS ERROR 

BUMP FCB RANDOM INDEX 

GET ACTUAL FILE SIZE LOWER 

WRITE ACTUAL FILE SIZE LOW 

GOTO FMS ERROR 

GET CLOSE CODE 

SET FCB FUNCTION 

CALL FMS 

GOTO FMS ERROR 

CLEAR STATUS CODE 

RETURN 



>>aaa>a>a>aa>aa>>>>>>>>>>aaaaaaaaaaaaaaaaaa>>>>>>>>> 
> a 

a ISAM FIRST ROUTINE * 

a a 

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaantnixa 



CLRA 




JSR 


FMS 


LBNE 


FMSERR 


INC 


33, X 


CLRA 




JSR 


FMS 


LBNE 


FMSERR 


INC 


33.X 


LDO 


RECS1Z.U 


JSR 


FMS 


LBNE 


FMSERR 


INC 


33, X 


LDO 


RECS1Z.U 


TFR 


B.A 


JSR 


FMS 


LBNE 


FMSERR 


INC 


33.X 


LDD 


MFSIZE.U 


JSR 


FMS 


LBNE 


FMSERR 


INC 


33, X 


LDD 


MFSIZE.U 


TFR 


b,a 


JSR 


FMS 


LBNE 


FMSERR 


INC 


33, X 


CLRA 




JSR 


FMS 


LBNE 


FHSERR 


INC 


33.X 


CLRA 




JSR 


FMS 


LBNE 


FMSERR 


LDA 


«»e-j 


STA 


0.X 


JSR 


FMS 


LBNE 


FMSERR 


LDO 


•e 


RTS 





TST 


CFLAG.U 


TEST CORRUPT FLAG 


LBNE 


ERR] SB 


CURRUHI FILE 


LBSR 


MOVVBI 


MOVE VARIABLE TO BUFFER 


LBSR 


FIND 


FIND KEN' PECORD 


LBNE 


EXIT 


EXIT WITH ERROR 


LDO 


M 


CLEAR STATUS CODE 


RTS 




RETURN 



aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 

> a 

a ISAM NEXT ROUTINE M 

> a 
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 



NEXT 



TST 


OFLAG.U 


LBEO 


ERRI33 


TST 


CFLAG.U 


LBNE 


ERR 138 


LDO 


CURREC.U 


CMPO 


AFSIZE.U 


LBH1 


ERR 1 78 


ADDO 


Ml 


STO 


CURREC.U 


CMPO 


AFSIZE.U 


LBHI 


ERR 178 


LBSR 


RRREC 


LBNE 


EXIT 


LBSR 


M0VB2V 


LOO 


tte 


RTS 





TEST OPEN FLAG 

FILE NOT OPEN 

TEST CORRUPT FLAG 

CORRUPT FILE 

GET CURRENT RECORD NUMBER 

TEST FOR LAST RECORD 

END OF FILE 

B1MP CURRENT RECORD NUMBER 

STORE CURRENT RECORD NUMBER 

TEST FOR LAST RECORD 

END OF FILE 

READ RELATIVE RECORD 

EXIT WITH ERROR 

MOVE BUFFER 2 TO RECORD 

CLEAR STATUS CODE 

RETURN 



FIRST 



TST 

LBEO 

TST 

LBNE 

LDD 
STO 
LDO 
RTS 



OFLAG i U TEST OPEN FLAG 

ERR 1 33 FILE NOT OPEN 

CFLAG.U TEST CORRUPT FLAG 

ERR 1 38 COftftUPT FILE 



88 
CURREC.U 



POINT TO START OF FILE 
STORE CURRENT RECORD 
CLEAR STATUS CODE 
RETURN 



a 






a 


a 

a 




ISAM CURRENT 


ROUTINE 1 

a 


CURRNT 


TST 


OFLAG.U 


TEST OPEN FLAG 




LBEO 


ERR 133 


FILE NOT OPEN 




TST 


CFLAG.U 


TEST CORRUPT FLAG 




LBNE 


ERR 1 58 


CORRUPT FILE 




LDD 


CURREC.U 


GET CURRENT RECORO NUMBER 




LBEO 


ERRI63 


START OF FILE 




CMPD 


AFSIZE.U 


TEST FOR LAST RECORD 




LBHI 


ERR 178 


END OF FILE 




LBGR 


RRREC 


READ RELATIVE RECORO 




LBNE 


EXIT 


EXIT WITH ERROR 




LBSR 


MOVB2V 


MOVE BUFFER 2 TO RECORD 




LDO 


88 


CLEAR STATUS CODE 




RTS 




RETURN 



■■■■ aaaiaaaaa a aaaaaaaaaaaaa aaa 

a 

ISAM LAST ROUTINE , 

" «« aa aaaaaa 



LAST 



TST 

LBEO 

TST 

LBNE 

LDD 

AODO 

STD 

LDD 

RTS 



OFLAG.U TEST OPEN FLAG 

ERR133 FILE NOT OPEN 

CFLAG.U TEST CORRUPT FLAG 

ERR 138 CORRUPT FILE 

AFSIZE.U GET LAST RECORD NUMBER 

"I POINT TO END OF FILE 

CURREC.U STORE CURRENT RECORD 

" e CLEAR STATUS CODE 
RETURN 



a a 

I ISAM PREVIOUS ROUTINE a 

a a 

aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 



aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 
> a 

I ISAM START ROUTINE a 



aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa 



PREV TST OFLAG.U TEST OPEN FLAG 

LBEO ERRI33 FILE NOT OPEN 

TST CFLAG.U TEST CORRUPT FLAG 

LBNE ERRI38 CORRUPT FILE 

LDO CURREC.U GET CURRENT RECORD NUMBER 

LBEO ERR163 START OF FILE 

SUBD Ml DECREMENT RECORD NUMBER 

STD CURREC.U STORE CURRENT RECORO NUMBER 

LBEO ERRI63 START OF FILE 

LBSR RRREC READ RELATIVE RECORD 

LBNE EXIT EXIT WITH ERROR 

LBSR M0VB2V MOVE BUFFER 2 TO RECORD 



START 



TST 
LBEO 



OFLAG.U TEST OPEN FLAO 
ERR133 FILE NOT OPEN 



LDD 
RTS 



CLEAR STATUS CODE 
RETURN 
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RAMBLINGS & Such 



Well, here I aa back again with aoae fairly good 
rumors and solid stuff. Aa well aa aoae more of Che 
rambling kind, Chat sect Co become nore aolld wlch age. 
That la Che nice chlng abouc being Che chief head 
knocker, nobody edlca your stuff, not wlch Che old red 
pencil, chac Is. 

Accually ire do noc have many red pencils here at CP1. 
I have cried Co lee lc be a more "free" flowing forua. At 
does chac haa miffed aome and delighted others. 
However, we have only asked one chlng of our auchors, 
please be faccuall Thac chey have been preccy successful 
ac. As a resulc lc has made my job more like plain fun, 
racher Chan work. 



several scace snd local government agencies where we and 
Che wronged reader have filed complaints. We are 
furnishing additional data to those agencies Co support 
the complaints and help show the general attitudes of the 
offending dishonest vendors. Fact la, we just got a 
conviction last month, based on oar related data. It la 
being appealed, but when It Is finished, you will know. 

What I want you to know la. It works, and 1 am keeping 
my promise to you. One state Dlatrlct Atcorney told me 
on the telephone that we were the ONLY magazine thac had 
cooperated ao fully wlch their Investigative proceedings. 



As you might have noticed, our advertising haa fallen 
off somewhat. Thac was Co be expecced. Some of our 
advertisers were under capitalized, but had good 
products. Others had good products and a potentially 
good future but either did not support their cuatoaera 
properly or "read" the future market wrong. For chem we 
really feel aad . 1 did all I could Co keep some of chem 
from going belly-up. Ail except those who did not support 
or ran off from and Ignored their past customers. Their 
abaence waa all the beccer for us remaining. Some got 
all "hot" for the "grass on the other aide of the hill". 
Moxt >>f lliem huve paid denrly lor that lolly. Itnwuver, 
there are successful ventures advertising In the pages of 
6S Klcro Journal this very monch, chey survived and grew 
and/or replaced chose who blew It. Which Just goes Co 
show chac chere really was a market here all the time. 
The aecret was In recognizing It. But Is la bitter sweet 
to me. I get no Joy from their nls f or tunc . I could 
Chink, "well, you goc what you deserved, tor noc 
listening." But everytlme one of them failed, we lost an 
advertiser, or availability to a good product, and that 
BDIT us all! 

So, there la really no euch thing aa being right In 
Chta Cype of situation. It affects us all. However, It 
does make lc a little easier for Che remaining ones as 
chere la a larger allce for each. So, for you Che 
reader/user It probably meana a aoaewhat beccer product 
and a supplier who now la beginning Co realize the 
beneflta of your good-will. As for us It means less 
advertising revenue. And that meana that we have to make 
It up somewhere else, or we regress, then YOU get 
cranked up. That financial alack haa been taken up, In 
pare, by S.I. MEDIA 4 DATA- COM P sales. Kverytlme you 
make a purchase from elcher of our divisions, you help 
keep us golngl And thac benefits all of us. 



A Sad Uord(a) of Caudon 

Also 1 need to caution you about purchasing from past 
issues of 68 Hlcro Journal (or any other magazine, for 
that matter). Especially if the seller Is not currently 
advertising. Seeoa that some of you will send In your 
money to a company thac haa even had chelr celephone 
dlsconnecced (CAUTION: sone sclll have their old number 
active, Just In case)l We are getting some complaints 
about a few past advertisers who will cssh your check (If 
you are dumb enough to send one blindly) but not deliver. 
■OTS: 1 said s "few". Please, please reaeaber, HOST of 
our past adverclaere AK£ honest, It is Juat a FEW bad 
ones! But until 1 do the full legal thing, 1 cannot 
mention their names. But rest assured I will as soon sa 
1 get the legal parts straight. We are working with 



If you need Co know the current status of *JTf of our 
past advertlaera - please gl«E me a personal call, at our 
office. 1 may be able to assist, and PLEASE remember. 
Just becsuae they are not presently advertising, does 
not necessarily mean thst there Is anything wrongl A 
litcle caution however, la better that Chan loac bucks or 
worse) 



Tell He Agslnl 

Crsnced, we are not the largest or even one of the 
lsrger markets, In the micro rat race going on now. But 
we have managed to survive because we were s group bound 
together by common Interest, snd equipment. Also, It I 
might, I believe 6B Hlcro Journal hss hsd, s not ao small 
part. In the longevity of our group snd market. And thst 
brings me to another point. As times have changed, we 
have tried to keep pace. So, I need your Input as to what 
type artlci.ee you want to eee more of In Che future. 
Drop me a line or ahort noce and lee me know what ¥00 
want. Shall It be more on languages, software, hardware, 
68XXX, games, applications or whst have you? Alao, If we 
were forced to using a aoaewhat cheaper grade of paper, 
etc., but kepc Che concencs Che same, would you objecc? 
I would like Co know. We need Co plan ehesd! One Chlng 
Is for sure, MS WILL NOT FOltCET THOSE WHO GOT US USUI 
Our 66XX coverage will continual II 



New Addition to JUST 

(Because so msny ask for it 

especially you OS-9 users) 

A Text Processor for OS-9 

and/or FLEX 

In "C Also 

Tom and Chris, over at S.E. HED1A, wanted ae Co 
mendon to you that they have a couple of nice updatea on 
the JUST Text Processor, from our Ron Anderson. First, 
there la now a veralon in "C", eo you OS-9 users csn 
compile and run It under OS-9. We will compile for you If 
you do not have s C compiler (but you should, it is a floe 
HLL). at no additional charge. It hae been a very 
popular text processor under FLEX. And haa been our 
beat eeLLing scsnd-slone cext processor for those who 
need or desire s text processor ChsC Cskes sdvsntsge ot 
Che sdvsnced fescures of their printer (especially EPSON). 
Also there is s version now that understands the TSC 
Text Processor commands (many) and alao Che advanced 
features of JUST, so thst if you have text in TSC format. 
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well, with little or no change* It can be edited and 
proceeded by JUST, It la called "JUSTSC". and will very 
aoon (probably by the tlae thla gete to print) be 
available from S.K. MEDIA. Alao note the "STAB- epeclale 
In their advertlelog catalog. They really try to give you 
real eavlnga and quality eoftware. I think they dncnt 
your loyalty, and aupport. 

An S)0/68XX Service Department 
(Recauae you aaked for It) 

Over the pact few years, and especially alnce eooje 
prior herdware manufacturers and vendora have dropped 
out, we never ceaee to get calla froa aoae of you. 
wanting to know WHO can repair their ailing S50 Bue 
aoaethlng or another. Until now you were forced to 
depend on the dealer (where did they all goT) or atruggle 
along on your own, If the aanufactii rer had drifted 
elaewhere. That hae been one thing that haa really hurt 
our marketplace. Cood aervlce la one of the aoat 
laportant Ingredients of the entire proceaa. 

Wall, for 8 yeara our DATA-COW Dlvialon haa maintained 
a fairly extenalve aervlce department. For thoae lteaa 
we aold only. Over the yeara we have aold an awful lot of 
SSO Bus atuff. And we have alwaya been In the position 
to give IMMEDIATE attention to anything we aold that 
needed eeivlclng. That la why we aold probably aore than 
anyone elae. Now. we have decided to give It a trial and 
make this aaae aervlce available to all of you. 

Data-Coap haa over $100,000.00 In available parts 
alone. Alao they probably have aore service data than 
anyone. Feet la, we have had aoae aanufacturera aak ua 
for coplee of aoae of their older diagraaa. 

It la not a cheap operation. In any aanner, but It 
alght juet be the only hope for aoae users. And we have 
atteapted to aake the thing ae Inexpensive ae poaelble. 
Therefore, we even have an "eatlaate" ayatea for $40.00 
plua shipping. That aeeaa a lot better than traahlng an 
otherwlae excellent coaputer ayatea. Thla aervlce le 
prlaerlly for "atore bought" ayateaa. Kits, while not 
being outright refuaed, will have to be evaluated on an 
Individual baala. A telephone call alght get a kit 
approved. Keaeaber, If you have a poorly put together 
kit, that aay have never worked properly, then the 
problea could well be apread over aore than one board or 
coaponent. In that caae It will require aoae special 
consideration. 

Hare CoCo Scuttlebutt 

Soae tlae back I "ruaored" to you that the 128K CoCo 
wee a dead duck. Well, It aeeae aore ao now. Deeplte 
Tandy and other nagailnea telling you otherwlae. 
However, another "rumor" la gaining ground, and It alght 
be aore accurate than the othera. 

Seeaa Tandy DID give up on the bank aelected 128K 
CoCo, or at leaat let It reat for now (one of their 
better decisions). Instead they "aay" market, later thla 
year, a 512K unit with a real hones t-t o-goodness HHU 
(memory management unit). Alao It probably will get an 80 
character screen (no Charlie, they are not going to 
Introduce a alnl-ASR31). Thla aachlne will be an 0S-9 
ayatea primarily, but ahould have aoae Klcroaoft and "old" 
CoCo compatibility. But I have alao heard that It will 
have enough dlfferencee In the Microsoft BASIC portion 
and DOS that aany of the preaent CoCo uaera will not be 
too happy] 

Now Tendy'a problea haa alwaya been with the CoCo'a 
selling price/profit ratio. That la alaply put; It sella 
for leaa, doea aore than aoae of their aore expenalve 
unlta, and thua generates far leaa "net" profit per unit 
aale. Example: A cuatoaera walka In and aak for a deao 
of a spread-sheet prograa. If It la done on the CoCo 
ualng Dynacalc end alao one of the other Tandy ayateaa, 
running their other apread-eheet software, the CoCo Oyne- 
calc veralon la going to be ao auch better that they are 
going to loae a larg* profit aalea to a low profit aale. 
However, If the CoCo la not there to compete, then they 
automatically get a high profit aale. Can you figure the 
bottoa line? 



Aa far aa the price goes, I know that la still up In 
the air, providing they actually get to market with the 
new veralon. But, If they do market (anything 6809) It 
will HOT BE AS UOXFIMSIVI aa the preaent CoCo. And that 
la what sells the CoCo - low price. Per a survey, over 
961 of CoCo uaera did not know what CPU chip waa In the 
CoCo when they bought It. And 62Z atUl don't know, or 
care. So look for a machine somewhere In the price range 
of S599-999. And that eliminates over 721 of the reaaon 
that preaent CoCo uaera bought their CoCol They bought 
on price alone. Stay tuned In for the continuing aaga of 
the "here now, there now" CoCo(T). 

The CoCo hae done aoae good for our community. Many 
original CoCo purchasers found reel power with the CoCo, 
especially with 0S-9 . However, the CoCo running 0a-9 aa 
oppoaed to a GIM1X or SSB running level-2, la about like 
hauling a boxcar full of brlcka In a W elnl-truckl And 
for thoae who atteapted to do any serious work In the 
CoCo DOS - well, that la spelled DUMB. Thoae aaae ueera 
opted to awltch rather than fight. We" gained by 
switching a Tandy customer, to a better product. That Is 
where Tandy needa to shore up their act. However, I 
predict that It will continue, which la ell the better for 
ue. So, pleaae Mr. Tandy - get that new, improved 
veralon of the (whatever kind) CoCo on the market, we 
need ltl We've never been agalnat it, we Juat wlah you 
would learn how to aake a "real live full function one") 
Maybe thla time, "Huh?" 

A REAL 68020 SBC la Coming From: 
Data-Coap Dlvialon 

That the 68008 la S-C-O-O-O-W la no aecret. That it 
la to be obaoleted aoon, la a fair aaauaptlon. We have 
benchaarka for It, the 6809 and 68020. In aany reapecta 
It la a real dog. Needleaa to aay, the 68020 la FAR 
auperlor to the 68008. Fact la, the 6809 for aany 
operatlona, la better) 

Data-Coap Dlvialon la now getting together a complete 
68020 ayatea, 1 or 2 aega-byte, that will be not only 
reaaonable In price, but completely compatible with all 
the preaent and future 68K aoftware available. Thla 
ayetea will coae in aeveral veralone. One a coaplete 
ayatea Including the CRT, dlak drlve(a) (floppy and/ or 
hard-dlak) and cabinet/power supply. For thoae of you 
having a C1MIX ayatea, a aiaple interface to allow power 
froa your G1X1X to run the 68020 ayatea (eave a bit). 
Alao a hardware and eoftware combination to allow "net 
working" the two, or aore. Several other "atrlpped" 
veralon are alao In the mill. 

So, If you have a hankering for a UAL 68XXX ayatea, 
thla will be it. Keep looking for the actual 
announceaent to be published aoon. If you want economy, 
aervlce and aupport, thla will be the one worth waiting 
fort They could have earlier offered you a dog, but as la 
their policy, they opted to wait for the reel thing. Now 
watch out for the H0STAH6-20. It packa a real klckt 
More next month or ao. 

And Another 68008 

And another 68008 SBC board la coalng. Can't tell 
you auch about It presently but It should fill a void not 
yet addressed by other aanufacturera. 

It will be a combination 6809/68008 ayatea. Although 
we do not have a lot of faith In the 68008, it will eure 
be better than aoae ol the othera out there. Alao aa a 
ahared resources ayatea It will allow you a lot aore 
latitude than the exlatlng 68008 ayateaa. 

Won't aay too auch about It now ae we have not looked 
It over or approved for advertising the final version. 
But 1 can eeaure you that It will be a very price end 
quality worthy ayatea, baaed on the preaent producta of 
the manufacturer. So If you really want to get Into the 
68XXX thing, thle gives you another option, from a company 
that will be around to aupport what you apend your herd 
earned bucke fori Which makea waiting a little more 
worth your ooney and tlae. 

DMW 
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PRODUCT ANNOUNCEMENT 
6809 - 680081.10 COMBINATION BOARD SOON AVAILABLE 



MUSTAMC-08/9 

Combination 

680081.10 & 6809 CPU Board 

For the S50 Bus 

Scheduled for the 1th quarter 1985, la another 
6BXXX/6809 S50 bus CPU board, from Data-Comp Division. 
CP1. A combination 680081.10/68B09E CPU board to convert 
your present 68XX aysteo to both a run 68008110 and 6809 
oomputer . 

Preliminary specifications provide for a 1 or 2 Khz 
6809 and a Cull apeed OOahz) 680081.10. These CPUs can 
run separately or concurrently. Speed is enhanced by the 
liberal use of 74F type ICs and PAL devices. 

a Memory mapping controlled by on-board DAT. The 

OAT Is software selectable. On board address extension 
to 12 bits for full memory range, with on-board decoding 
(8 bits). 

■ Interrupts can cross Interrupt other CPU, and 
680081,10 can be single stepped by the 6809. Monitor ROM 
space will have provisions for 4 2716/64 EPROMs and/or 
2817A-286* EPROMs. 

■ A 68040 timer Installed with no wait states. 
Both BUS REQUEST and HALT 0MA supported, as well as 
MEMORY READY. E clock la a true square wave for tight 
timing considerations. 



plna. 



All connectors gold plated. Including jumper 



Several extra 20 pin 1C locations for expansion. 



* DIP selections use the newer type "piano" dip 

switches, located on top of the board. This allows all 
switch setting to be done without removing the board. 

This Information should, aa atated above, be 
considered preliminary, however, the project has 
proceeded to the point that the above portion of the 
specifications are fairly firm. We tell you this now in 
order that you might consider it as an alternative 
solution to upgrading to the 68XXX CPU. While not as 
powerful as the MUSTJkNG-020, It does allow the present 
68XX user a viable upgrade option, using most of his 
existing hardware, and 6809 software. 

Delivery date and final price is not available at this 
time. However, the price should be very competitive with 
presently available 68008 systems, that have far leaa 
power and options. And again, far less expensive using 
your old hardware, cabinet, etc. 

Interested readers should contact Data-Corap for 
delivery and price Information , but not sooner that 
October 15, 1985. Delivery slots now being allotted on a 
reserve basis. 

DATA-COUP Division, CPI 

5900 Cassandra Smith Rd . , Hlxson, TN 373*3 

Telephone: 615 -8*2-4601 

TELEX: 558 41* 788284 

HATE YOO READ ANT 
GOOD BOOKS LATBLYr 

by Ion Volgta 

I've juat gotten a book that might be the answer to 
■any OS-9 uaers" prayers. The one question I've heard 
many tlaea la "la there a good book on OS-9?". At Laat, I 
can answer, "There lal" 



Now you can get "Ths Ccasplste lain bow Guide To OS-9" 
by Dale 1. . Puckett and Peter Dibble. These are two 
authors that to Boat OS-9 uaera need no Introduction. 
But (or newcomers let me tell you about them. Dale 
Puckett la the prealdent of the 0S-9 Uaers Croup and 
author of the "Baalc09 Tour Culde" froo Mlcroware. Peter 
Dibble la a graduate student (working on a PhD) In 
computer aclence at the University of Rocheater and 
author of the "0S-9 User Notes" column in the off" Micro 
Journal. Between the two of then, you are looking at a 
lot of 0S-9 knowledge and experience. 

Usually when I write about a book I like to tell you 
what la in it. Thla book la about 0S-9. 1 mean 
everything! There's the 0S-9 history-, tti hardware snd 
softwsre. The book talks sbout the 0S-9 file structure 
and Input/output system. The Culde covers all the 
commands from A to X, I mean form AT TR to XMODE. 
Puckett and Dibble also cover the languagea -- eeeenbly 
language, Baaic09, C Language and Paacal. There la the 
0S-9 meaory, the dlak foraata, file managera, device 
deacrlptora and drivers. Thla book covera both Level I 
and Level It ayatems. And there are programs, and 
programs, and acre programs! Thla la all in the book and 
aore. In fact, there are 417 pages of 0S-9 information. 

The book covera 0S-9 (primarily) for the Color 
Computer uaer but la uaeful for the Standard user. It'a 
a good "getting started" book aa well aa a good guide for 
the Advanced Uaer for writing Device Deacrlptora or what 
ever, and It makes an excellent 0S-9 Reference Manual. 
So, If you are looking for aore Info about 0S-9, take a 
look at "Puckett & Dibble". 

0S-9 USER NOTES REVIEW 
Written by Peter Dibble 

l was very excited when my fist issue of the 68* 
Micro Journal came. I read eveiy article and column It 
had. I paid special attention to one of the columna. It 
waa the "OS-9 USER NOTES," by Peter Dibble. The column 
Interested me, since I aa an avid user of 0S-9. After 
reading the column, 1 had one regret. I wtahed I had 
been able to read all the columna froo the beginning. 
Unfortunately, the 0S-9 USER NOTES had been published for 
over a year by the time I atarted my subscription. So 
there waa over a yeara worth of valuable information and 
programa that 1 had mlaaed. 



Now to the reacue comes Peter'a new book, THE 0S-9 
USER NOTES, VOULME ONE . It la a collection of 19 colunna, 
starting with number one and continuing for 18 more. It 
Includes all the programs. It even Includes the reviews. 



Nothing haa been left out, 



The obvloua place to start with a book like thla la 
to begin with column one and go on from there. I think 
the flrat columna have special historical significance. 
Flrat, they were the only literature around at that tine 
for 0S-9. Also, they show the development of 0S-9. In 
Column 2, Peter had Juat received hla updated version of 
the 0S-9 system. The new version Included commands, like 
PWD, PXU, snd DEI.DIR. 0S-9 users now consider these to 
be standard part of 0S-9, but not always. Bealdea the 
0S-9 development, the flrat coluana cover good info like 
forking to a process, using multiple fllea and 
lnterproceaa communication. 



My problem la I can't wait to flniah a book. I guess 
my curiosity gets the better of ne, so I started paging 
through the 0S-9 USER NOTES. There la a lot of atuff 
here! In the year and a half he haa written the column, 
he haa covered quite a bit of material. There la auch 
more covered than I could possibly mention. Bealdea the 
things I noted earlier, he covera thlnga like Paacal, 
dlrectorlea, device deacrlptore, plpea, the Color 
Computer, CompuServe, useful hints, suggeationa and OS-9 
food for thought. 
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On* nice feature la a 3 page Index at the book's 
end. Indexee are good places to look for thlnga. 1 
found a lot of OS-9 aeterlal, I had alaaad In my random 
paging. Ivarythlng thet Peter haa written In the laat 
year and a half la neatly Indexed for quick reference. 
Everything he haa written In coluana 1-19 can be easily 
found In the Index. There are thlnge thet I had not even 
thought about, Ilka the TANO OKACON, raaterlxatlon, and 
HOTD. Long after you raad the OS-9 USER NOTES cover-to- 
cover, you'll be wanting to look thlnga up. This handy 
Index will let you find thes feet. 



Pater's book slso hsa all the reviews that appeared 
In the '68 Micro Journal, They Include 0-F, OS-9 CIS 
COBOL, DIDIT, ST9, D-Serlee Utilities, DYNACALC, DYHAMTE, 
RMS, RMA, and KLINK. Hla revlewa are a«ay to follow and 
understand. Ha glvee a product overview, polnta out aoae 
datalla and llaltatlona of It, and ande with a neat 
• unary, it you have any lntareet In theae producta, 
youll went to eee hie revlewa. 



Progress! They're all hsrs. All the progress that 
sccompsnlsd the coluana are In this volume, They are In 
8ASIC09, C Language, Aeeeably and COBOL. Soaa are 
flnlehed producta and others give you e etert towarda 
developing ycur own. There era benchaarks, plpsa, device 
drlvere and utilities. There la even a prograa to aake 
your Color Coaputer aaka nolee. If you went to add 
prograae to your ayatea (and who wouldn't}, youll want 
thaee. And there la aora good newe. If you hste to type 
In progress, you csn gst thea all on 6" disk or 5" dlaka. 
You can get thea In Coco or Standard OS-9 forast, tool 



If you'rs llks as and alaaed eoae of ths columns, 
this Is your big chance. They're all here — coluana 1-19, 
ths ravlews and the progress. Even Lf you have all the 
66' MJ'a with the OS-9 USIR NOTIS , youll still want this 
collsctlon for quick saay reference. It puta thea all 
together In one place with a handy Index to look up 
elaoet anything. The book la available In loose leaf fora 
to add to your uaer notea or you can gat the deluxe 
binder for It. And don't forget the progrsaa ire on dlek 
for your convenience end uae. They ere all available 
froa; 

Coaputer Publlehlng Inc. 

5900 Caaaandra Salth M. 

Hlxaon, TN. 37343 

(615) 842-4600 



PRICES 

book $9.95 

binder $5.50 

B" disk $14.95 

5" disks. (2). $24. 95 

If you lntsrested, give CPI a call. You can alao check 



out the edvertlaeaant In thle lasue for OS-9 USER NOTES 



VOLUME OH». I think you'll really be glad you got It. 

3.N. KEOIA 

Special Value Kits 

4 

Bargain Hunters Program Corner 

S.E. MEDIA has always attempted to bring you Software 
at reasonable prices. Our catalog attest to that (act. 
And of all the coaputer magazines I read, 68 Micro 
Journal brings to you aora source listing of useful 
programs, than any of the others. Also our Reader Disk 
Service, was a first. It has saved many millions of finger 
keystrokes, over the years for our group. 

However, there Is a sort of grey area between those 
programs we publish and the commercial ones. And that Is 
the area we hope to fill. Programs useful to most of us, 
but not capable of generating much profit. I know there 
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Is a lot of it out there, I receive quite a bit already. 

One of the hardest things I have to do soaetlnes Is 
reject a piece of software for lack of a reasonable 
narket. Or as soaetlnes happens, the author Is not 
completely knowledgeable as to the many different versions 
and variants of FLEX. FLEX alone has over 12 different 
versions that are Incompatible, to some degree or another 
with some specialized software. Without that knowledge 
many fine pieces of software never Bade It. 

To "Seta" test a particular piece of software we have 
to run It under several different FLEX systems, with 
various and assorted digital and linear devices attached 
to the host system. I have seen many nice software 
offerings fall due to the reserved space of say a 
Winchester Interface board, or a clock or A/D Interface 
board. To name Just several of meybe 25 or 30 different 
devices available to be used with S50 bus machines. Each 
of which, or the RAM used or reserved, could send your 
program off to that "land of twisted bits", or worse. I 
guess that Is why the really good software available Is 
more expensive. The time and effort to completely 
compensate for all those insslbllltles is costly and tine 
consuming. 

You would be surprised at how many software offerings 
we receive from folks who do not realize that not all of 
us run FLEX with the memend set to 1BFFF. Fact is, most 
of us do not! If you have SUTPC FLEX for the 6809 you 
probably use the SUTPC relocating printer drivers, that 
always reside below 1CD00. Space Bust be reserved for 
then prior to their use. Also practically everyone with a 
disk system uses some memory below FLEX. Yet, we receive 
even supposedly commercial software that demands a aeaend 
of tBFFF. Considering that probably 60-7%t of all FLEX 
is either CIMIX or SUTPC (not completely the same), each 
with different RAM considerations, It can really get to be 
a "can of worms". 

If you are going to develope software for resale, 
especially if you Intend to sell It here, then I suggest 
you make certain you really do understand all the 
ramifications. That can save us all an awful lot of extra 
work. Nothing gets my goat more than to have a piece of 
test software "eat" up a disk, and then discover that the 
author coded things In such a manner that it would only 
work with his version of FLEX. 

For those offering 0S-9 software, things are somewhat 
better. Some software will not run under level two that 
was developed for a level one system. Or Just the 
opposite. But on the whole 0S-9, because of more 
stringent control by Hlcroware, and the natural order of 
0S-9 development requirements, leaves less room for 
lncomjJatablllty . However, it does exist and the author 
Should be aware. 

So you ask - what is the answer? And to that I can 
not give a "pat" reply. It would be beat lf you tried 
your newly created programs on various S50 bus systems. 
I Imagine that is impossible for some of you. But. that 
Is what we do. We have practically every type S50 bus 
system and every different version of OS-9 and FLEX that 
has been released (and some that have never been out of 
our office). Still occasionally we run Into the 
"personally modified" version, and the author forgot to 
let us In on the "good news". Those kind sometimes make 
us want to become cod fishermen or something. Exanple: a 
recent offering on a PERC0M disk modified for soft 
sectorinn. Took us a couple of hours to get It off and 
over to another system for evaluation. It failed. 

I will try to help you in any manner I can. But you 
ere going to have to aeet me at least half way. If In 
doubt, call me. Sure it might cost you several bucks, 
but it could save that much alone, whan we start passing 
the stuff beck and Ibrth, by mall, UPS or what have you, 

1 hope I have not discouraged you. But It is to both 
our advantage If you know some of the possible problems 
ahead of time. If you have a good and useful piece of 
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software, let me know. However, realize that about 
everyone has an editor, assembler, word processor, BASIC 
compiler, etc. So what you have to offer must either be 
a lot better, or sell for a lot less. Otherwise, It could 
be Just wasted effort for a conmerclal venture. 

In the past we have "Beta" tested software, for some 
of our more successful software vendors, for a reasonable 
fee. But. this Is somewhat different. For then we will 
continue to neke our essorted facilities available for a 
modest fee. But for the low cost, budget - bargain 
hunter software offerings, you are going to have to get 
It right on your own. 

If you need advice or help, give me a call. 



DHW 



My Time 



For years now 1 have occasionally taken the liberty to 
use a little space here to expound on something I felt 
was important to us all. But what follows is a first. It 
Is the first time that I have actually "plugged" one of 
our own products. 

However, changing times and conditions have imposed a 
different slant concerning some aspects of our basic 
policies. One is our involvement in retelling. It can be 
a sticky situation. On the one hand we have other 
supporters (advertisers) who also pay to sell their 
products In 68 Micro Journal. They are certainly 
entitled to every consideration. And on the other there 
is the natter of maintaining a decent, publication (68 
Micro Journal) for you. We are sometimes between the 
proverbial rock and o hard place. It has been a tight 
rope affair so far. and I have tried to not step on any 
toes or allow our close association with both ventures 
(publishing and selling) to be a real bone of contention. 
But it has, at times. And may be again, but we have to 
consider all our options. And they appear to boil down 
to this. 

First, I am determined to continue the quality of 
material in 68 Micro Journal, as in the past. Mind you, I 
said quality, not slick or pretty. Something useful, that 
Is our quell ty. Bear with me as t burden you with soae 
(decimal) numbers. Eech Issue of 68 Micro Journal cost 
us about $1.86 each to print and nail, including postage. 
Don't grab for your calculator, it cones out to 122.32 
for eech of you, a year. A net gross profit of only two 
bucks, more or less. Based on our present (don't 
anticipate any Increase) $24.50 yearly subscription cost 
to you. Evan less If you paid for 2 or 3 years. And all 
those life members are coasting. Those cost do not cover 
the cost of our physical plant, our rent, lights, 
telephone, heating and cooling, Insurance, salaries and 
all thoae other expenses necessary to keep any business 
going. That really adds up to a bundle each month. The 
net result has been that we come out on subscriptions 
versus net operating expenses to the tune of about minus 
J10.00 per subscription, per year average. 

You might wonder now we do It? Staple, we run lean, 
by that I really mean super efficient. We use our 
computers in every aspect of our operation. We make do 
with about one quarter of the number of office personnel 
as other publications our size. Also we are supported by 
those advertising dollars we generate in 68 Micro 
Journal, and extra income generated by our DATA-COUP and 
S.E. MEDIA divisions, plus some consulting we do for the 
electronic and digital industry. However, our advertising 
income is over SOI down and there is not as much 
consulting now for 6800 and 6809 markets, in Industry, 
here or abroad, as has been in the past years. Also I 
occasionally plok up a few bucks on the cream chicken and 
toast circuit. That my dear friends is why we have hung 
in there while others collapsed all around us. We 
operate within what we are able to generate, and we 
anticipate the oceilng market potentials, on a continuing 
basis. 
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A few years back I was offered over a million bucks 
for this operation. That was an offer not to be lightly 
considered. I turned it down. Stupid, you say. Well 
maybe, but I started this thing, not really to make money 
(did not/do not turn my nose up at it either) but to do 
what none of the other magazines would do - give us some 
exposure and support for our systems! Fact is, I never 
dreamed it would grow to the proportions it has. I felt 
that if 1 sold, they would not actually support us as I 
thought was needed. History has certainly proven me 
rluht on that one already. They did buy another going 
specialty computer magazine. Paid good bucks, let It 
slide for a couple of years and then folded the whole 
operation, practically overnight. Glad it wasn't usl We 
may some day take a few active stockholder partners, but 
never let it all go. 

Actually ail I had In mind to begin with was a 
newsletter type thing. It. Just got out of hand with so 
many manufacturers wanting the advertising exposure, I 
postponed the first Issue for a couple of months, ordered 
better paper, and — zip — 68 Micro Journal was born. I 
consider myself very fortunate to have had such loyal (for 
the most part) support from those same advertising Iblks. 
We owe them a lot, all of us dol 

Meanwhile back at the ranch - The reason I bring this 
all up Is to let you in on where we stand. We are atlll 
in good condition, as a business, but we do see the 
future to be somewhat, different than the past. If we 
continued to Just drag along, doing the same old thing, 
without considering where our market is going, we would 
be doomed. Maybe not right off, but not too far down the 
road. Also you have my published pledge not to forget 
who brought us this far - you and our advertisers. So we 
are committed to continue with 68XX(X) material. No IBH, 
Apple stuff or any other brand not using one of the 
68XX(X) devices. We have again locked ourselves Into a 
fairly narrow field. But that is what you wanted and paid 
us for, and that is what you will get. This has left oe 
with a hard decision. Where will the support funds come 
from? 

The support we need will have to cone from the three 
sources mentioned above. With advertising revenue down, 
expenses up and the market being narrowed considerably, 
there is Just one logical avenue of operation left to us. 
Sell more of the products you want through DATA-COHP and 
S.E. Mt:DIA! If we are to survive end grow, that appears 
to be the only logical solution. If any of you have a 
better Idea, please let me know. 

Also another strenge thing. Through It all our 
subscriptions ere still growing. Most iy oversees, but 
still growing. Which really means we have more loses to 
contend with (overseas is a little more). Actually we 
need them, for It is the readers who buy the advertised 
stuff, that gives our advertisers their advertising budget 
value. Who contributes to our overall financial welfare. 
Sorta confusing, but simple IT you ponder it In the broad 
aspect of various sources of revenue. Which boils down 
to this: 

We will be expanding into additional retell resources 
and marketing. What follows is one that we are presently 
working into. So please renember, we are not really like 
jll those other magazines. And for the most part you are 
not like all those other readers, of those other 
raagezines. Which does not mean that we are really 
different, but I do wonder about those other guysl 
Imagine buying a computer that is slow, expensive and you 
can't modify hardly any of the code or program to or 
modify the thing to do your particular thing. Horrorsl 
But it is happening more and more. Have you noticed that 
S.E. Media software being sold as their own or under 
license has source available. And In a form that you can 
work with. Great, isn't ltt Host every piece of S50 bus 
hardware I know of has more documentetlon freely available 
than any of those other guys. Including Hazelwood. And 
there are still kits and bare boards available. Maybe 
that is why one of the largest kit manufacturers In the 
world has recommended 68 Hlero Journal to some who asked 
them where the kits were. 
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Below is a new Item from Data-Comp. We offer the 
following without apology, We owe It to you, our loyal 
renders and advertisers, to Insure that we continue to 
survive. We do not desire to compete. Just co-exist, 
Also you will find that most everything we sell Is 
purchased from our supporters and advertisers, as 
needed. How many can say as much? So, read on. 

Dota-Coap Nuatang-020 
Super SBC 

The folks over at our Data-Comp Division have been 
busy lately, more so than usual. They are putting the 
finishing touches on their new 2,000,000 byte, right 2 
Megabyte 680*0 computer. Aptly named - NUSTANG-020 
Super SBC. Of course we all know what the 020 means - 
68020, right. But why Muatang? Simple, because it has 
one heck of a kick! And as for Super - well, Just look 
over the specs, and the price. 

Bear In mind this Is not a stripped down, bear-bones 
128K or even 512K system, but a full blown 66020 CPU with 
2 Megabytes high-speed DAM. If you are going to do. or 
already have attempted to do any serious work with a full 
32 bit CPU, then you know wnat I r.iean. And if you expand 
It to additional users under the 0S9 66K. multi-tasking, 
multi-user disk systea, or any of the other multi-user, 
nulti- tasking disk systens soon to be available, then the 
extra RAN Is lwperatlvef Actually It cannot then be 
considered eitra KAH, It is necessary RAH. 

Talking about speed, well, the Muatang-020 Super SBC, 
compared to the other 68008 or 68000 systems. Is a walk- 
a-way. With the tnalh processor chip Installed (option) it 
does some things so fast, you will think it didn't do 
anything, Without the eo-processor It Is si. Ill the 
fastest and most efficient of then all! 

because we wanted (no, demanded) that It be adequate 
for all available functions, we have designed the power 
supply to a stale or "loaf along". Or If you want, we will 
furnish the necessary options to allow you to Just buy 
the basic system and use your existing cabinet and power 
supply (appx. 100 watts required for boards, one floppy 
and one Winchester), 



I would recommend that you review carefully the 
specifications in the current Data-Comp 2 page ad. 
Please note that this la a 2 Megabyte system, It has 
onboard co-processor and other options, it has bua 
expandability, it runs at the full 12.5 megahertz. The 
Motorola 020-BUG (value *500.00 current going price) Is 
Included at no additional cost, and Is necessary to 
extract the full 68020 capabilities. The cost difference 
between this and other 68XXX systems Is well worth Itl 

The MUSTANG. D20 Super SBC Is not the cheapest 68XXX 
system around. There are several cheaper 68XXX now 
being sold. But none, no not one, has the full power of 
the C8000 series as this *8020 does! The original cost 
difference is well Justified by the power and utility of 
this as compared to any other 66XXX system. Actually, 
there are many other 68XXX systems of far less power, at 
much higher prices. For those of you who cannot 
understand why the difference In prices between the 68008 
and the 68020, note this, the 66008 chip Is priced at 
about 128,00 each. The 68020 chip Is on the order of 
$300.00 to $700.00, according to quantities purchased, 
etc. However, the price should drop drastically when 
Motorola changes from the pin grid array to a 6M pin 
dual Inline chip. That should be soon. Still the 68020, 
considering power, is a bargain. Some stiff price 
difference, but well worth itl It Is kinds like the 
difference between roller skates and a Lear Jet, IT you 
are serious - then the HUSTANG-020 Super SBC Is a 
bargain! 

I suggest that If you are serious about a real 68XXX 
system, you might want to consider thi' "reservation" list. 
Just the rumors of this system has generated many solid 
orders already and production will be behind for awhile. 

Call any of us at Data-Cosp, we will try to give you a 
fairly accurate delivery date, and current prices. Or if 
you Just have questions, call, that Is what we are here 
Tor. 

Contacts: Tom, Larry or Don 4 we thank you, 

■ HUSTAHG-020 and Super SBC are trademarks of Data-Comp 
Division, CP1 - Hlxson. TN 373«2 
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We will be furnishing OS9-G6K, Stylo, Mali Merge, Stylo 
Spelling Checker, JUST (still under 68020 development) and 
PAT, a new and excellent second editor, also other 68XXX 
software on a continuing basis, Fact Is, Data-Comp has 
made arrangements with 66 Micro Journal to furnish all 
68XXX article programs on a disk, to all MUSTAKC-020 
owners, for a small handling and shipping charge only. 
This software alone is worth practically half the price of 
the basic system, And as time passes it will allow you to 
continually Increase your software acquisition, at a 
fraction of what others will be paying. In addition there 
will be a FI.EX like (ouch advanced) 66020 disk system also 
available, from Star-Kits, called STAN-DOS 6SK. This will 
be a single user system that will use the FLEX disk 
format. Consider the ramifications of that) Add to 
that the soon to be released UnlFLEX 68020 system, anil 
the possibilities keep expanding) This is not a system 
that will soon be obsoleted. Others may, but this 
computer will be the one compared to for years to cone. 

I understand that several popular C compilers will 
soon be here, along wltn a 68XXX version of PL9. And 
don't forget SCULPTOR (available now from S.E. Media at 
prices below anyone else), it is running already on the 
68020. 68020 software Is developing much faster than 
66XX software did, so it seems to me. It is because of 
the simple portability of OS9 and UnlFLEX source, and the 
soon to be released FLEX like (not TSC) 68XXX operating 
system. Data-Comp will also offer solid discounts on 
practically all available software fbr this or any other 
68XXX system, for those who purchase a MttSTAMG-O20 Super 
SBC direct frora Data-Comp or one of their registered 
dealers. The reully nice thing about it is that If you 
buy a used one from some one, and confirm the original 
purchase to Data-Comp, you will be eligible for the same 
free software, Jlscuunts and other privileges aa the 
original purchaser, from that date forward. Try and bent 
that! 
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Larry Williams 
'68' Micro Journal 
5900 Cassandra Smith 
Hixson, TN 37343 

Dear Larry: 

The review on our ST-2900 6809 system ('68' Micro 
Journal Dec. '84 pp. 15-17) needs some clarification and 
amplification. 

1 must stress that if you purchase our FLEX Conversion 

Package, no prog ramin g of any kind is needed to bring up 

FLEX for the fTrst time"! ATT you do is follow simple 
Instructions and prompts to Insert the right disk at the 
right time, and 30 seconds later you see the famous "♦+♦" 
FLEX-1 s-ready prompt. What could be easier? To create a 
directly bootable disk you Just run the supplied FORMAT and 
SYSGEN utilities, respond to a few prompts, and presto — a 
bootable disk with a configured and linked FLEX. SYS file on 
1t. 

The price of the FLEX Conversion disk has always 
appeared on our price list, and Is only (USHZ9. Despite the 
low price, this is more than a mere bare bones adaptation. 
For example, FLEX's autoaatlc drive searching has been 
properly Implemented. And detailed logging facilities are 
available to keep track of disk 1/0 errors (if any). 
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Source code for FORMAT (the replacement for NEWD1SK) Is 
Included 1n our optional "FLEX 1/0 Routines Source Code 
Package". By the way, our FORMAT ts fast -- only 58 seconds 
for a 40 track, double-sided, double-density disk. Complete 
source code for ST-MOH 1s also available separately on disk. 

The trlmpot adjustments (for "motor on" and "ready") 
mentioned 1n the review are not fussy, and we now supply the 
DCHECK utility which lets you set them without test 
equipment. DCMECK also displays the rotational speed of the 
drives. Some of the competitions' systems require an 
oscilloscope or frequency counter to adjust the read data 
separator and write preccmpensatton. Ours are entirely 
digital, so require no adjustments at all, and will never 
drift out of adjustanent over time due to component aging. 

Recent Issues of '68' Micro Journal have presented 
hardware and software patches for some other systems to let 
them read and write disks fonnatted with GIMIX vs SWTPc 
"side flags". ST-29O0 users have always been able to read, 
write, and format FLEX disks In either format -- no patches 
required. 

All partially assembled boards are now tested before 
shipping, so should come up first try (assuming the customer 
supplied parts are OK). Unfortunately, Don Williams' set was 
not tested -- we won't make that mistake again! A few months 
after the review appeared we also began shipping fully 
populated/assembled/tested boards. 

The manuals referred to 1n Don's original review were 
only the pre-production versloi.s -- the current set are 
considerably Improved, both 1n content as well as In 
appearance, as Don mentioned 1n the Feb . '85 update. 

The review put considerable emphasis on the effort 
required to adapt software to the ST-2900 because It doesn't 
use "the 'normal' 6821 and 6850 ACIA or PIA Interfaces." The 
facts were accurate, but needed to be put Into proper 
perspective. What do all of the following 6809 systems have 
In cannon? 

- Radio Shack Colour Computer 
• Digital Research Unlboard 

- Sardls Technologies ST-2900 

- Artisan DP-09 

- GIMIX with Intelligent serial I/O processor board 

- GIMIX with memory mapped video board 

They al ) Implement the console port with something other 
than a 6850 addressed at SE004, thus requiring patches to 
any software that bypasses the FLEX 1/0 routines. I probably 
wouldn't have brought this up, except that the Unlboard 
review the following month didn't have so much as one word 
on this subject (as opposed to several paragraphs for the 
ST-2900) even though the same situation exists . In any case, 
as Don's February update Indicated, the supplied Instruc- 
tions on patching the software packages are simple, and 
"once done they run the same as on any other 6809 system," 

The 6522 VIA used to Implement the parallel ports is 
very similar architecturally to the familiar 6821 PIA, when 
you Ignore the VIA's added features such as the shift 
register and two 16-bi t counter/timers. Even Its plnout Is 
almost identical . Selected pages from the data sheet are 
Included in our documentation. 

The 2681 DUART chip is becoming very popular. Even 
Motorola is second sourdng It now. With a few changes 1n 
sone of the control lines, and a different part number 
(68681), It is used 1n many 58000 and 8086 based systems. 

Although the ST-2900 1s a two board system (soon to 
become three). Its inclusion 1n the "Single Board Computers 
-- 6809" series of reviews was no accident, as the CPU board 
can run by Itself as a non-disk SBC. One customer 1s using 
it as the basis for a print buffer for his Macintosh, 
another as a Baudot to ASCII converter for RTTY reception 
(the 6850 ACIA used on other systems cannot handle 5 bit 
Baudot characters! ) . 

Finally, the ST-MON monitor and the OS-9 Conversion 
Package have been significantly Improved over the past 
several months. Refer to the enclosed Information sheets for 
details. I recently sent Don Williams copies of the latest 
versions. 

With best regards, 

JHC.U 

David C. Wlens 
Sardi s Technologies 
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Contents of the upgrade package 

1) ST-29UU OS-9 Conversion Boot disk — latest version 

2) ST-2900 OS-9 Conversion user Manuel — latest version 
)) ST-M)* 2.04 upgrade package — described separately 



Installation procedure 



1) Install St-hDm 2.u« -- refer to th* separate ST-HOn upgrade Instructions. 

2) Follow the Instructions In the new OS-9 Conversion users Manual 1n 
these sections: 

al 'booting Up OS-9 Kltn The Conversion Soot Dim" 
bl 'Sacking up The ST-2900 OS-9 Conversion boot U!>(" 

c) 'Creating A hew Bootable ST-2900 OS-9 Systee U1sk (after booting up 

fro* the Conversion Boot disk)* 

d) "booting Fran A Configured ST-2900 Systdi Disk' 

J) All configured system disks that otre created by the preliminary version 
should be replaced by system disks createo by the new version. Files froo 
til* "old" disks can be copied over to the 'new* disks. 

4) Check ill. uf your disks to ensure that the old versions of "OS98oot" . 
"Sfomat'. "Bootflx* "Booumup" are deleted end replaced by the new 
versions of "Sfoi-aat* , "kernlf In", "Kernlseve" , "Noilflu", and 'uspeee". 

Sumury of differences batmen the preliminary and current versions 



LI The new version Is compatible with bath version Ul.00.00 and 01.01.00 
of CoCo OS-9 -- the preliminary version woulo not work with version 
01.01.00. 

2) The new version will let you run the console ten I nai (serial fort A) 
at any baud rate -- the prel lalnary version would only run at 9600 ops 
even If you tried changing ST-MON. 

J) The new version lets you use terminals that require B data bits with 
the high order bit a Mro, as «ll as thute with unty 7 data tilts -- 
the preliminary version always assured 7 data bits. 

4) The new version doesn't care about the status of the cTs input line on 
serial Port B during the boot procedure -- the preliminary version would 
hang up I f tTT on Port B was not asserted. 

5) In conjunction with the new version of ST-HDn. you can now boot up from 
drive 0, 1. 2 or 3, not Just from drive 0. This makes 1t easier If you are 
using a 3 1/2* drive es drive W end want to temporarily connect a 5 1/4" 
drive as drive »2 or t> fro* which ts boot up the distribution disks. 

6) in conjunction with the new version of ST -HUH, you can now use a 96 tpl 
disk drive for the boot drive without first having to oake 9» tpl copies 
of the ST-2900 OS-9 Conversion Boot disk and the Radio Shack CoCo OS-9 
Systen Master olsk. 

71 [n conjunction with the new version of ST-atON, you can now directly boot 
up a configured system disk without the hassle of using the Conversion 
Boot disk . 

61 The configured boot disks may now be created In either CoCo or standard 
OS-9 format. 

9) The new rOuFU utility makes It easier to cliange values in the CLKt 
module and disk device descriptors. 

10) the new OS PEED utility lets you adjust the tw irlmpcu on the FUC board 
without any test equipment, the sane as with our FL£* Conversion package. 

11) The SulSk.29 parameters for direct sector read/write hove been modified to 
be canpatlble with D.P. Johnson's latest version of SOISK. This makes It 
posslole to run his PC-XFtR utilities. PCXftit lets OS-9 read, write, and 
format IBM PC-iOS / US-DOS disks, as well as read and rite Medio Shack 
CoCo Risk bASIC disks. 

12) The OS-9 kernel Is now contained In a regular OS-9 disk flic. Instead of 
mysteriously hidden on track 34 Hike the CoCo does). 

13) The ST-2900 OS-9 Conversion Boot disk has jrtn dionged to be In uS-9 
format, not FLCH f onset. This simplifies the procedure to create 4 backup 
cuoy or a configured system disk. 

14) The »n«d la 60UU0 wEbus OS-9/66X systnml ill* rorwt can now also be 
read and written. 

15) The ST-290U utlll ties WiOlBKOr, BOOTSAVE, and 8001FIX have been replaced 
by the new KERNLSAVE end kernlfij utilities. 

161 The track number at which write precaapensatlon Is enabled Ifor double 
density) 1s no longer fined at 43. but can be changed. 

lrl The OUART driver now elso supports 19,200 oaud. Since the higher baud 
rates often require I-ON/i.urr hendshaklng, that has heen implemented as 
«*i I. 

Illl A device driver Implementing and bit parallel printer port (using the 
6S22 VIA) 1s now Included, with source. 

19) The source code uf all device descriptors Is now Included on disk. 



This document last revised August 2. 1965. 
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Content! 0' upgrade pact age 

1) 27J2 EPPCPt containing Sr-MM 2.04 

2) SI -NON 2.04 User Manual 

If you KM previously hi*- chiud the source coat of ST-HOh 1.01. ni can get 
the ittNi code of version 2.04 for only [tUS] llu plus our re-jut a r snipping/ 
hendlln, fit. 



initillitlon proc 



1] Turn off the ST-29uU'l POver supply, volt several itcoWl lw allov tin 
voltages to drop, then disconnect tht power supply frqa. the IPu board. 
Take appropriate precautious to prutect against Static electricity, Co 
avoid omji to tha ocu Emu") or Utt rest of tht ST -2900 systea. 

2) Carefully renove tha S1-H0N I.UI IPBU* from Its socket on the CPU eoera. 

3) Insert tit* S7-K0* 2.04 £«0H Into Its IC socket on tut CPU boir*. If tht 
socket has 2B pint, out sure you "lover Juitlfjr". th* EFMUH In Its socket, 
it. leave pint 1, 2, 27, 28 of tht socket optn. 

4) Change jumper J6 on tht CPU board fro. tht *16* to tht "32/64- position. 

5) Folio, tht Instructions In Apptndln C of tht ne» ST-NON aanuel to 
configure wrltl port A for baud rati till dtti blti. 

6) Rt-connoct tht power lupply cable to tht CPU board . 



i> of dlfftrencts between version 1.01 ind 2.U4 



11 Vtnlonl.Ol reoulredyo* to turn t not EPPUH In oroer to chanoe tit baud 
rati of tht console port to other than Kw baud. Version 2.U* led you 
svttch select aiong 100. 1200. 960V, 19<u0 ueud ulthnut any changes lu tht 
IPIlOH. 

2] Vf»tun 1.01 «i not compatible «lth tenvlnals rtqulrlng 8 data bits with 
tht high order bit a itro. version 2.04 lets you suited select betvetn 
' or a data 01 u. 

3) Tha own that prevented you froa specifying 192UO ops hes bttn lined. 

4) (1.01 did not hart thy coaemnd to elrectly boot up a configured OS-9 
tystee disk -- It elvays required tht Inltrattflttt lilt of tht S J -2900 OS-9 
Conversion loot dlsa. V2.04 lttt you dlrtctly boot up a configured US-9 
dllk. 

5) (1.01 did not properly support t 9b tpl slit drive for tht drive you boot 
frou. Distribution disks containing tha FlEi ana OS-v Conversion peckedel 
ene tna FLEX and 0S.» optriti'tj systevs, «n1ch art usually supplied on 

ao tpl oiaks, flrit had ts ba copied to 96 IP I dim. il.u* eliminates 
that copyiig by all owing you to invoke "doublt-steppliej* at boot t*ee to 
boot dlrtctly from ao Ipl disks In a 96 tpl drl>t. (Note — tht current 
version of tht Fit* Comerslun Pectaue hat not ytt bttn enhenced u uake 
ma of this ST -HUN feature.) 

t) Ihe 0IITCH8 and OUTOM routines In vl.01 havi Mm rtpiacto by * single 
ntv OUTCH routine. 

7) Tht bug In tht 'Injiut chtracttr* routines that did not reset the overrun 
error condition land *beeptd" tvtry tint you keyed a character once tht 
trror ms sell has bttn fixed. 

a) ST.«0n no lonqtr dtslrdys tht contents of >00lK>-Su0vS at potcrvip or syitea 
rtsot. 

9) If you should ever utt Sr-MOx's "ha* ("bad gm'\ nesit«« tfttr pouerup or 
s/sttai rtstt, ST -HON «Oi no* till you «htt tht eddrtss of that bytt alt. 

10) VJ.Ot lttt you boot tht FLO or 0S-9 optratlnu tystvi fro» drivt u, 1, 2 
or J. not Just froet drive 0, This atkts It poillblt CO utt a 3 1/2* drivt 
as drivt fO. a 5 1/4* urlvt can bt taMOrarlly connected as drtvt 1, 2 or 
3 froai veiled to boot up tht S t/«" conversion package distribution disks. 
(hott -- tht eurrtnt vtrilon of tht FUl Convtrslon Pccka9* has not yit 
be«n enhanced to aaki utt of this SI -HON feature.) 

11) ST-HON. In a F\tl lor STAR-DOS) tiwlromtnt. not occuplts slightly wri 
■aorj than before, beginning at If»4£ Insttad of IFB94, 

12) Stvtril new PAH locations have been defined I reftr to aeniel for tort 
dttallll: ARIOPC, ART0P1, POIIeC. OILSTP. «EtfLI. CMUTtB. 

13) Tap nex routlntt have bean added that lit you easily witch Oetween tht 
SAM chip's too aeaory aaps IRON/PAH vl all-RAM. 

Ihls docuatnt list nodlfltd Aujutt S, 1985 

Don, 

I've been hearing about you elnce you started ■ 
neuipaper aone yeara ago. Soooe of ua In the ham 
world were Itching to get Into conputera but 
didn't think It waa practical. Then we heard that 
you were using a email computer to run aeveral 



aapecta of your paper- That la when we decided 
that coaputera were practical after all. 

I have been aware of bUMJ for eoae tlaa? but 
never aaw a copy. When I found out you were the 
publlaher 1 lamedlately aubecrlbed. 1 an not 
dlaappointed . What your magazine lacka In ejedla 
It sakee up for In claaa, atyle, and content. 

Now for a queatlon and a tip. Plrat the 
queatton. 1 wrote a almple phone book data base. 
The data file la too large to fit In memory. I 
only work on one or two recorda at a time and move 
deleted racorde to the end of the file during dlak 
aort. How can I chop off the end of the file (the 
part with the deleted recorda) without ualng a 
temporary file to atuff the good atuff? I an 
ualng bae(c09. The problem with the prevloua 
method Is that I can only uae half the dlak. 

Now the tip. If you accidentally etart to 
format a data or aource dlak. It la poaalble to 
recover part of the text If thlnga haven't gone 
too far. Thla la aaeumlng you ripped tha dlak 
from the drive before the fornat got to the data. 
At thla point your root directory la ahot and you 
cannot uae chd or dump 9/dl. So atlck In a blank 
dlak and run format. When It aaka for a dlak name 
replace the bland dlak with blown dlak. Now type 
In anything and preaa enter. The formatter will 
create a new root directory (although practically 
empty) and then try to verify that the dlak la 
formatted. Nine tinea out of ten you will get an 
error, but that 'a okay. Now you can uae chd and 
dump aucceaefully. Or you can uae another dlak 
duap utility aa long aa It doea not require a file 
name paat the root directory. 

P.S. "Uncle" Karl Dunn and tha 3907 gang want 
to know when Rufua la going to have the bbq ready? 

Thanka. 
UB9RLC 

Richard King Jr. 
P. O. Box 216 
St. Bernlce, IN 
4;B75 
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Hiiik, TR 373*3 

Dear Don, 
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If I don't get writing to you aoon, I'll probably get 
out of the habit altogether, but I don't aeea to have 
done too much that'a new aince I laat wrote, except to 
patch XBAS1C to incorporate an EDIT command. In 
conjunction with BIDIT (a BASIC line-editor) it allowa 
one to enter, lay, EDIT 300 (aimilar to LIST 300) and 
Line 300 of tha XBASIC program would pop up ready for 
editing - with char-inaert, char-delete, overlay, etc. 
Along the way, of courae, 1 juat couldn't reaiet 
enhancing BED1T itaelfll 

Thia work got aa to thinking that perhapa readera 
would be intereatad in learning a little about how 
XBASIC carriea out certain taaka. Several yeara ago I 
did a maaaive atudy of XBASIC, long before 6609a were 
thought of. I bad a bone-brew 6800 ayatea then, with 
juat a caaaet te-dr ive for atorage, and envied ay 
frienda who had a diak-drive, aa they were uaing FLEX2 
and XBASIC, while I uaed either ay monitor or 
Uiterwyk'a 8K-BASIC, with no DOS equivalent at all. 

So ... commencing with a hex dump of the then current 
veraion of XBASIC, I aet about the taak of 
diaaaaeabling it by hand (aa you've gueaaed, there waa 
no caaaette-baaad diaaaaeabler available to me). Took 
ae about 2 weeka, working eveninga, before 1 had it 
all done - but I aure learned a lot about 6800 
machine-language programs ing along the way, and a lot 
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more about the inner workings of XBASIC. In no time 
at all (actually about 3 or 4 days), I had it modified 
for cassette LOAD and SAVE in place of the disk 
routines, and a whole new world of programming in 
BASIC opened up for me. In the beginning, it would 
take si no st 1} minutea to load, which was very 
fruatrating if it didn't load properly and I had to go 
right back to the beginning. Later on I purchased 
JPC's high-epeed loader, which brought the time down 
to about 50 seconds I! We sure bad fun in those dayel 

After thai, I played around with it for s while - 
studying the different wsye in which it atored 
programe in memory sa compared to teving them on diak 
(cassette). So let's begin here, keeping in mind that 
any Hex addreaaea quoted will vary from one veraion of 
XBASIC to another - the onea quoted actually go back 
to my original PLEX2 vereion. 

Let'a euppoae we've keyed in the following abort 
program, in the order ebown : 

5 A-3 

10 B-5 
7 C-9 

A aimple LIST would diaplay the linea in correct 
numerical order, while an examination of the aame 
program saved to disk fusing a program such aa 
D1SKED1T) would show exactly the same thing. So it 
would aeem natural to auppoae that thia ia the way 
XBASIC actually atorea the program in memory during a 
LOAD or keying-in operation. "Hold on there!", 
exclaims the more knowledgeable reader, "Everyone 
knows that each line forme part of a linked liat, and 
carries s pointer to the next one in sequence, with 
the pointer for the final line being 0000." Let us 
therefore perform a dump of the actual Program-Memory 
for our little program. Here's what we'd aee : 



4B05 06 07 08 09 0A 0B 0C 0D 0E OF 10 11 12 13 
00 05 4B 23 7E 80 00 00 69 A4 00 03 01 33 7D 

ABU 13 16 17 18 19 IA IB 1C ID IE IF 20 21 22 
00 0A 00 00 7E 80 00 0B 69 A4 00 OS 01 35 7D 

4B23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 30 31 
00 07 4B 14 7E 80 00 16 69 A4 00 09 01 39 7D 

4B32 33 34 35 36 37 38 39 3A 3B 3C 

80 41 00 00 00 00 00 00 00 00 00 

4B3D 3E 3F 40 41 42 43 44 45 46 47 
80 42 00 00 00 00 00 00 00 00 00 

4B48 49 4A 4B 4C 4D 4E 4F 50 51 52 
80 43 00 00 00 00 00 00 00 00 00 

Juat imagine - all that code to represent our simple 
3-line progrea juet sfter we've keyed it in. What 
doea it all mean? 

Well, the first three linea with hex-addresses sbove 
are the actual program lines, snd the last three form 
the Verieble-Stack, which is where XBASIC keeps track 
of the values sssigned to the vsrisbles of the 
progrsm. Let's begin with the progrso-lines . 

At the left-hand edge, it'a quite obvious that the 
first two columoa contain the Line-Number in hex, snd 
in no time st sll we see thst the next two columns 
contain the link- qddtess (not the ectusl line-number) 
to the etsrt of the next line IN NUMERICAL ORDER (not 
the order in which we keyed them in). But what about 
the 7E in column 5? Thia ia XBASIC'a way of knowing 
that the program-line ia aeparated from ita line- 
number by one apace. If the eta tement-line were 
indented by more than one apace, a 7F would be atored 
here with an extra byte after it to indicate the 
number of apacee. So you aee, as far aa program 
memory ia concerned, only one extra byte ia uaed up — 



no matter how many apscea you indent sfter the firattl 
Not ao when it'a aaved to diak, however. 

Column 6 contains an 80, which tells XBASIC that the 
line begins with s Floating-Point variable-name (84 
would signify sn integer Z, and 81 a string $), snd 
the next two bytea indicate the dieplacement of the 
variable in the Variable-Stack. A'a displscement is 
0000, ie it's the firet, B commencea 11 bytea in, and 
C 22 bytes in. Notice thst the progrsm line itself 
does NOT specifically identify ita variable aa A, or 
B, or C. 

69 ie the "token" for the '»' eign which follows. 
More on tokens later, and how you can apeed up XBASIC 
a little by modifying ita Conmand-Table and Statement- 
Table. Let's move on to the next byte, sn A*. All 
our variables are equal to A4? No, what thia means ia 
that each ia equal to a constant (not another 
variable, as in the statement A"X) in the range i or - 
32767. The next two bytes indicste in HEX the vslue 
to which the variable is being set, followed by its 
ASCII equivalent. That ia , 01 aaya there is one digit 
only, and in the case of A, it's equsl to ASCII 33 (ie 
3). Finally, each line enda with a 7D, which ia 
XBASIC'a token for a CR. 

There's not much to the Variable-Stack. The initial 
80 in l hi- firat line says thst thia variable is PP , 
its name is ASCII 41 (ie A), and ita initial value ie 
(indicated in the following 8 bytea). However, the 
moment the program ia RUN, XBASIC will aeeign the 
correct valuea to theee variablea ae it encountere 
them in your program. 

So much for Leaaon One. Try writing one- or two-line 
programs, with simple statements such ss A*X or 
AI(1)"9, or better still AZ(1,2)"15, snd examine your 
Progrsm Buffer to see whst bsppena. Don't forget to 
clear it to all zeroee before you start, otherwise 
you'll only get confused with gerbage left over from 
previoua teste. 

If you'd like me to continue along theee linea, 
including moda to XBASIC, pleaae write to Don and let 
him know. If I get more YBSea than NOa I'll keep going 
for a while. Bye for now. 

Sincerely, 



o« 



F. Jonea 
Preaidrnt 
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COWUTEH CONSULTATION. SOTHAHE. DOCUMEN TAT >u*. A HASOWARt 

P.O. Box 9802 - 81$ 
Austin, Texas f8766 

Wellwrltten Enterprises Is pleased to 
announce our relocation to the High-Tech Center of 
the Southwest — Austin, lexas. We will continue to 
market the finest Inexpensive SS-So hard disk 
subsystems. Please note our aa elsewhere In this 
issue. We anticipate only s oriel' interruption in 
service but until our new facilities are 
completed, we will be without s permanent, phone 
number. Please write to us if you have any 
questions and. If leaslble, we will phone you with 
the answers. Hlease include your daytime and 
evening phone numbers and suggest the best time to 
call. 

Thomas J, Weaver 
President 
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Dear Don 

Well hurricane Elena li somewhere Co Che aoucheeec of ue 
ec chle dae buc eelde from chac nochlng elee la going on 
here In Peneaa City. So I decided Co write a prograa Co 
keep ay Hind off Che weather. The following la whec I 
cent up wlch and I choughc chac you Bay be lncereeced. 

The Tovere of Hanoi gaae conaleta of chree pege arranged 
In e line. On che rlghcaoac peg there ere a aec ol 
gredueced rlnge, Che amalleat on the cop. The objecc of 
che gaae le Co move Che rlnge Co Che lefcaoec peg, one at 
a tine, without putting a larger one on a smaller one. 
Thle gaae la aort of a claaalc. 

While reeding e text on Ada I caae ecroee e neat 
algorithm thet eppeare to a* to be elegant. The thought 
occurred to ae thet I could aaybe tranalate It to PL-S. 
My atteapc le encloeed. 

Two library fllae ere ueed; the flrat ecreube.Ub are the 
at ring handling routlnae. The other le loeube.llb; which 
are the etandard input output routlnae. 

Ae tn ell FL-9 prograae the aaln procedure le laet. In 
other worda the prograa atarte at "procedure Hein". The 
dete of aaln conaleca of chree acrlnga and an Integer. 
The flrec chree llnee preloed che acrlnga wlch che neaee 
of che pege. Then a new line coaaand ta given. Next che 
progrea requeace cha nuaber of ringa Co aove. Thle aay 
be any nuabar becween 1 and 99. 1 would noc recommend 
crying over 10 ee 1c mey cake e while Co prlnc all che 
aovee. The nuaber of rlnga le returned froa che funcclon 
IN^NUHBKR. Ac chle dae enocher new line (crlf) la 
Issued. Then che procedure N0VE_THEM la called and 
anocher new Una coaaand la given. 

Procedure IS KUMBER ellowe che lnpuclng of a cwo digit 
declael nuaber. Thle le eccoapllehed by paeelng che 
eddreee of e cwo byte etrlng to the procedure Input, one 
of the proceduree In loeube. The while loop converte 
thle etrlng to en lnceger. Thle integer le then peeaed 
back to the celling rouclne. 

H0VE_TMEK le e doubly recuralve procedure. Tbla Mini 
chat le calta Iceelf cwlce. lacha dae 1c calla 1 tee If N 
le decremented until N Is eqnsl Co one. Then lc eterca 
backing ouc, buc In che proceee lc calla Iceelf egeln eech 
dae. I know of no elapler explanation of this. Of 
courae chla procedure la ac che heert of che algorithm, 
end parhepe eoae other reeder cen coae to ay reecue with 
e betcer explenetlon of this routine. HOVEJTtlEH cells 
PHINTJJOVES twice. First when N goee to one end then 
eech dae the routine backa ouc. 

PRINT_HOVBS prince che cwo scrlngs Source end Declination 
with an arrow between thea. It then doee a carriage 
return - line feed. Print end crlf are In loeuba. 

I do went Co apologise again for not having a better 
explanation of MOVE_Thll£M but It gate pretty tengled aa N 
lncreeeee. I would like tn point out thee the eecond 
tlae It cells lteelf the chree acrlnga are displaced one 
place Co che rlghc in a circular Banner. 
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pr Int I" — ' *l| 

print i. Do •li*«l leni i 
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I heve Juec got one of these greet little boarda to 
run 0S9. Considering ell the outetendlng cepeblJltlee of 
thle combination, 1 wented to derive the aextaua 
potential. So, the challenge wee to figure out how to 
aqueexe a little more out of the boerd. My lntereet wee 
• specially piqued by the fact that 6876»'e. which ere 8k 
BPROMS, will work In the EPROH aocket, albeit only one 
helf et a tlaa. My SwTPC ayetea la modified eo that the 
address epece le completely decoded, and the I/O tekae up 
only 32 bytee of epece out of the corner of e 2716 EPROH. 
So, chle extende froa SE020 to JK7FP. It turne out that 
a elaller decoding echeae works on the PT69 boerd aa 
wall, eo thet the 6876* will extend froa 58020 to SPFFF. 
I plen co uee che additional EPROH apace for eoae of the 
0S9 eyecea routlnee, euch ee SHELL, CLOCK, etc. Thle will 
aeke the Boot ehorter, giving ae about 16 extra pegea. 

The additional decoding consists of only 2 IC'a, which 
cen beet be mounted on a daughter boerd thet plugs Into 
the EPROH eockec. For a plug, I use e 24 pin wire-wrap 
eocket---vhlch becoaee ths Kl'ROH socket, end provides 
eddreee end power llnee for the decoder. Two wiree (each 
ebout an Inch long) excenc fru (he hoard Co che aocher 
board. The tracea to the existing connectlone on the 
lC'e heve to be cut, ofcouree, but both cute cen be Bade 
on the eolder aide of the board. 
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To coajplata tht aodlf lcetions, eddreee Unct All end 
A 12 hava to be connected to thp Ef>ROK socket . While the 
juapar J8 could conect All to pin 21. In the 68764 AI2 
(pin 20 on the 680SE) ahoulrl conne:t here. likewise, run 
a Jumper froa the All eonnertlnn *n JR to the centin 
r innectlon on J13. The work la completed hy lolnlnir tlv 
two outer connectlona on JI3, to (round 'he chip nclec . 
lr «ay be neceeeery to nmrc R."\ to reduce the him 
loading. 



Classified Advertising 

I-CMIX #79 Sy»t(« OS/' 111, <rtth 5 Meg, Byle PUnl-H.rd ni.k plua 
V" DSDD Drive, alao Dual A" DSOO Otek Sjrel.Bwhti Controller, 6- 
Serlal Porta. {-Parallel Porta. JS6i: '72 Card and «-#67 6«( 
Card a. 

I-PT-6* coepl.lv with Duel J" DSOD Dlek SreteaAnd Controller. 
Inrludre Tlr.x 0»S. 



OK, here'e the circuit diagram, but If enough people 
ahow an Intereet, Peripheral Technology will ajske up e 
plug In board, eo, give thee, a cell at 404-973-0042. 

*** 
M MOTOROLA IMC. BimUa. cfmraCT. v.l M«r 
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RZADEK COrtACT. Wad* Vv.tt 



teitv*!ti9* mtotntsiion canitci 512/440-2035 

8-BIT HPU AMD MCU PAM1UES BROCHURE AVAJIABLE 



AUSTIN, TIXAS AUCUST IS, I98S- . - The Mle roconputer 
Operetton of Motorola'e Mle roproceeeor Products Croup 
announcee evalleblllty of a brochure Illustrating the 
breadth and versatility of Motorola's 8-blt NPU/HCU 
product fenlUea 

Hotorola'a three NCU f aallles— H6801/N68BCII, N680S, end 
M6804— end two NPU fanlllee, the N6800 and N6809, ere 
clearly Illustrated end deacrlbed in this 12-page 
docuejent. it not only covers the hardware, eoftware and 
option features for the core NPU end NCU faraHlee, but 
deacrlbea available developnent aupport end new producte 
as well. 

Thle eeey-to-uee selector guide la available through local 
Notorola ealee offices or authorized Motorola 
dlatrlbutors. Ordtng ualng BR26I. 
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Compact 
Flexible 
6809 
Computer 

Toe new ST7S0C ayalom - a camplele64K small tmatnesa or hobbyist computer 
IS only one Of na many possible ConfiQuralfOns. Among its features are 

• Smal 1 enough lo hold In your hand! IE urocard aire: 3.9"«6 3") 

■ Three b04rd"syetenY* lor Qrea lerreraa Hilly Irian sing leeward compu [era. 

• CPU Board -pomerlul U09E procaasor. |6K or 4K RAM. 1K-32K EPROM. 
2 RSZ3J aanal pons with soil ware programmable baud rates. Id bo countor/tltn 
er Run the CPU board all by Itself, or plug your own custom bo *d or our f DC 
board and/or RAM-SI? boa rdrnto the expenaion connector 

• FOC Board * doubte-sldeoAJou ble density floppy disk ognlroll r wilh adjust- 
menl lies digital data aeparator and write precompenaalron 2 A.b*1 p rallel 
porta.? l&bitcotjnternimera.piotoiypinga/ea 

• KAat-slt ajwirtf - S2.J88 bytes of RAM on a 4 lS"i6 T board* Low power 
Includes HAM Oil* soil waia lor f LEKor OS 9 

• FLEXandOSOtuVportet) - eeftar era seJaeubla. 

• OS9Cortrer»xxi Package lalayou use the low cost Radio ShackCoCo version ol 
0&9on our ST 2900 a slant Save JI31 oil (he suggested list price ol OS9' 
Ma aroejranvnlnt le In.aleed. Supports CoCo OS* staOOard OS9. and 
MIZAROS9j68Kd.sk lormata Con>paliO»ewiHi PC XFEBIo I I you ru HI write! 
formal MS-MS * a kal 

■CPUMraOowdpluaEPROM M5 OS-9 Conversion Package (49 

rDC bare board tX FLEX Oormeiswn Packer*. X2t 

RAM 41 J board A* T UBS CPU . FDC * OS-9 Conrrr ajon (119 

CPU « fOC boaid set eaaamoled ana lasted 1329 

• Add t$shlpping/nendhno (110 overseas;. T Hess prices are m US funds. C na 
dianoroera calloi writelorpri aa Terms: che k.rnoney order. VISA 

O.tfarre^, FvE* 1«cnnKM&lftiw«Cenhw*l*ni»ose Uic.im ■>* s lAMOirxl MS DOS - «<iwoei 

SI jS* jv rs^ i jS Cai«wftr»toilreet>rocfiuni 

£<HNoLOOI£< 

2261 E. 11th Ave. Vancouver, B.C.. Canada V5N 1Z7 



TELETYPE Ho«Jel 4) PRINTER - with lerUl (RS2J2) Interface, and 
full ASCII keyboard- LIKE NEW - New coat $129^.00 - OKLT 5559.00 
ready to run. 

S/09 vllh Notorola I2QK RAM, ]-HPS2 t 1-ParalUl Port, HP-09 CPU 
Card SI990. 1-QKAP2 Dual 9* Orlvta «\th Controller S2190. I-CDSI 
20 H*j* HmrA a ah Syitaa with Cnnt ntVmr 57*RO. 

l-S* Syatetj with 256- HAM, l-r(PS4, l-Parallel Port. KPtl Procvaaor 
Board. UnlPLEX Included S2700, l-QUl 10 Heg 5" Hard COk & B" 
Dlak Drive with 0HAP5 Controller Board 5)600. 1-XI2 Terminal 12" 
S1260. l-Cablnet for 9* Sritsa w/PUIer pi «t r 9%0U. 2-4212 
Teralnale 5**5. 

I «U1 acaapt e«7 reeaaaaVle emmmtwr-wttrnw 11 
Call Toa (615) H«2**600 M-P 9 A.M. to 5 F.H. F..S.T. 

«** 

Several SWTP 9+ Syateaa Avallabtft: Below dealer coat, n«>w 
equipment warranty, lota o( eottware available. 
Plndera Pae. 5L2-82fl-2679 

Por ttlc: Pl&X 6809 aoftvare. Moat of the TSC packages plua CSC 
Dynecele and 0ynaalte+. Ail approxliiatiily hall price- Aieo IBM 6 
Inch dlaketlea. SASI of call for Hat. Prank Weaver, 22 
Elliabetti St.. So. fur Itnjtton, Vt . 05A0( t <602> 66t-22%6, after 
5PM EST. 

a*e 

Por Sale; Ctadi: J05-CPU, #68-Con troller , '«3-Serlal, #42-Pirellel, 

f/6-Vldao, (CKXRUC09-V2.2P, Autoboot-Vl.%, OS9 CNXII-VI.2 r. PVFr 
Inatalted); 2-Di«tr*l l***>ar*h 56H-l*>Ort# Statlr Has, l-5«« kit, 
SWTKC MP-E Proa Burner; ACrtktN I6BX Proa btfard. Poflowlng 
* ■•« abled unteated: AAA Chlf «j[o Elect re Motherboard w/*otd 
connector*. E le c tr a DPS Dual Serial; Sunny Int «• rnt tonal PS 
*A v /25a, *L6v/1a, -l«*/)a; Acorn XAtM Extended AddreaatfiK, FOBS 
Plravara Oavelownc l.S. PALME*, P.O. *o« 115. Portaaouth, Va. 
2)705. <604> 198-6646. 51600* 010. 



TOWERFUL COLOnGRAPHlCS 
Uie»lhe new TMS9tttSA Video Dis- 
play ptocesor Hrgh resolution 2f>6 * 
192 p.«el atiplav w.Ih lb CDtcii 16K 
Bylfl* ol onboard RAM ooos noi *educe 
v%oi memo y 32 graphic imngaa can 
t>e .ndiwitiuaily moved wikn simple X V 
commands tor amoclh ammnlion 
Eitemnl vmeo mput allows sunniiinq 
NTSC co^Poailfi vtdao urpul 
SOUND EFFECTS AND MUSIC 
eThiee AV3«9lO Piog.ammahle 
Sound GenSrelOfi 

« Nine stmuiianeous vo<c(* 

a Three mdePOndeni rxMse s urces 

a Onboardsrereo amphtier drivos two 

6 onm apeake'S 
ADQMQHAL 10 CAJ> ABILITIES 

• EkjM arvakjg mpajia wilh fl bit res*> 
MM 

a Support Hour rov**'c<v?vyrtKoirtr»bul 
id i* 'it net 

• E^gnt nil tMiallai I/O port 

• Enr.re on.l Tvapa rfilo ?S6 bvies of 
memory 



iilll 



TLWMilSIUS DESIGN INC. in conjunc 
tion mtti MrcroMrareSy^ldmaCo'porn 
t.0rt t> plana lo announce F BASIC an 
cnh^ritfmt'nt ttf MicrftWeill! a 8600/ 
BASIC Thoir last comoiiBEJ BASIC has 
baajn .irkipicd tat HtlGft usei&wnth added 
.idf?o jind isound Fearurp^ loi ARCADE 
SO users FBASlC is. a true cofnoler 
lhal prodLfcen opTirni/ed machine Ian- 
cjuihjf mod Dl*aa. W htc h are ROWablti «inri 
require no Run Timp par.kaoe F EUSEC 
requires i»?si memory overhead and 
runs riurvireds oi limes taller than 
BASIC mterpfoier* it support sian 
djrd BASIC mjll uc Iron mcluOinrg 
Strang I unctKx-« Drsk I/O and fail iMeger 
arithmetic t«ith muitipfe^pfecrsion ca&» 
fr-nl> Graphirs verm *nd function* fully 
rtuppO't the Arcade SO 



ARCADE SO auembiod a*x) lesied 

V«leo and Aud«conmKloi set 

4 Joyitack connec lor Ml 

2 Radio hack Joysticks 

Goto Mob" connectots 

AJ BASIC lot 6800 

FBASlC for HOB 

FBASlC (w.th A CADE SOI 

ARCADE SO RGB 

iABVlDEOtMolOfOla EJORIXjU 

NE W MV0&6B09 Pioc«i.toi Board 

236K Dynamic Memo* y B aid 

2S6K Dynamic M««no*y Board <w 64Ki 

G4K Oynarrwc Meffrfwy BOtird 



S3?S00 

1500 

1500 

24 00 

1200 

11000 

11000 

7500 

37500 

375 00 

255 00 

795 00 

39S0O 

295 00 



n ims t \sm \rs s 



TERMINUS DESIGN INC 
16 SCARBROUCH ROAD 
ELLtNWOOD. CA 3004<» 

,,., (404) 474.4S66 
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OS-9 M SOFTWARE 

SDISK— Standard disk driver module allows the 
use of 35, 40, or 80 track double sided drives with 
COCO OS-9 plus you can read/write/format the 
OS-9 formats used by other OS-9 systems. $29.95 

SDISK + BOOTFIX— As above plus boot directly 
from a double sided diskette $35.95 

FILTER KIT #1 — Eleven OS-9 utilities for "wild 
card" directory lists, copies, moves, deletes, 
sorts, etc. Now includes disk sector edit utility 
also $29.95 ($31.95) 

FILTER KIT 02— Macgen command macro 
generator builds new commands by combining 
old ones with parameter substitution, 10 other 
utilities. $29.95 ($31.95) 

HACKER'S KIT #1— Disassembler and related 
utilities allow disassembly from memory, file. 
$24.95 ($26 .95) 

PC-XFER UTILITIES —Utilities to read/write and 
format MS-DOS'" diskettes on CoCo under 
OS-9. Also transfer files between RS disk basic 
and OS-9 (requires sdisk). $45.00 

SOLO prices are CoCo OS-9 format disk, other for- 
mats (in parenthesis) specify format and OS-9 level. 
All orders prepaid or COD, VISA and MasterCard 
accepted. Add $1.50 S&H on prepaid, COD actual 
charges added. 

SS-50C 
1 MEGABYTE RAM BOARD 

Full megabyte of ram with disable options to suit any 
SS- 50 6809 system. High reliability, can replace static 
ram for a fraction of the cost, $895 for 2 Mhz or $995 
for 2.25 Mhz board assembled, tested and fully popu- 
lated. (Add $6 shipping and insurance, quantity dis- 
counts available.) 

O.P. Johnson, 76SS S.W. Cedarcrest St. 
Portland, OR 97223 (503) 244 8152 

(For best service call between 9-11 AM Pacific Time.) 

OS-9 I* a Iradamaifc ol Mlcrowore mnQ Motorola Inc. 
US-DOS IB a trademark ol Microeoll. Inc. 



COMPILER EVALUATION SERVICES 
By: Bon Anderson 

The S.E. MEDIA Division of Computer 

Publishing Inc., 

is offering Che following SUBSCRIBER 

SERVICE: 

O0MPUJU CCWAIISOI UD IfiLDATIOl UPOIT 

Due Co Che constant and rapid updating and 
enhancement of numerous cospllera, and the 
different utility, appeal, speed, level of 
coaaunlcatlon, aeaory usage, etc., of different 
cospllera, the following services are now being 
offered with periodic updates. 

This service, with updates, will allow you who are 
wary or confused by the various claims of coop Her 
vendors, an opportunity to review comparisons, 
comments, benchmarks, etc., concerning the many 
different compilers on the market, for the 6809 
microcomputer. Thus the savings could far offset 
the small cost of this service. 

Many have purchased compilers and then discovered 
that the particular compiler purchased either Is 
oot the moat efficient for their purposes or does 
not contain featurea necessary for their 
application. Thua the added expense of 
purchaalng additional coapller(s) or not being 
sble to fully utilize the advantages of high level 
language compilers becomes too expensive. 

The following COMPILERS sre reviewed Initially, 
■ ore will be reviewed, compared aod benebmarked 
aa they become available to the author: 

PASCAL "C" CJSPL WHIMSICAL PL/9 

Initial Subscription - $ 39.95 

(includes 1 year updates) 
Updates for 1 year - $ 14.50 

S.E. MEDIA - C.P.I. 

5900 Cassandra S-ith Sd. 

Rtxaon, Tn. 37343 

(615) 842-4601 




aJJtatBUO »k*t 

iltttra Sugar tut IFIO Carnal Eiikin Chniml Earning 

Enltra Sugar tSUI soaiib Caning 
Cwiihi ■ rnv SubbIi 

llugut SI 50 Cio i.niiii. ISO 00 

Dm Mfulmf MOO 

Drat fafelaaK plan D»t»l KM 

laaa»rMWIIM{macan| 9*5*0 

NMiMOMMCPU I7JO0 OJOO 

Dual Part Sarin CM BOO 4000 

3.11 Pel Parallel Cars MOO 10 00 

Static Rea Cart ?M 00 aVA 

V/l' 7MN2 State Frapof Camrallar 111* lot) 79500 I DO 00 

Flei/Star DOS Ortrsre MOO 

U4 Drlvm 4000 

iiiiln 0S-S ■/ttcwr. tuaiw DUraHer now 

Entire Star MS 7500 

Write or phone lor current pi icing 

AAA Chicago ComputtrConttr 

120 Chestnut Lane — Wheeling IL 60090 
(312) 4S9-04S0 



u 

H 

I H Mlrli WlKMIer Silttaa 

AtRMniDll Cannoft Wincnsltar SflTtati 

DM1 WiiKlwlw I leegf SS MMsil IfllatlKI 

MO S Dual Mease Cabinet arth Ptner Suppl) 

"0 1* Fanr Wimtaittr Cabinet 

■ IIP, Piatf Sutjl, 

■DUWDual WlKCMHtr Clbntl 

•in rm UMi 

taktaa CiMa Mr Dul tabuil ■wtaw 

Misban [awe iv Dual infteafd ria|pM 

KOI Duel I Fuhh Catirni nitP Pewer )up||i 

■ibbart Cable lar Dull I' Flapom 

Uiiriai Catla 0* Mosul 

30 fir PreWiping ten" 

M f in FretMiping lurl 

comeciods 

DsM ridel 10 Pin Mill IS*>a>e Nelil « FMeil 
Til Plum 10 Pin Dili |$aueri Poaul ar futlli 



SS3EMIIE0 

JSOO 



39500 
I SO 00 



isooo 
woo 
xoo 

36000 
MOD 



■IKE 



750 00 



150 

IM 



'■"■.■■ I : j -i « alt* r 1 1" t 



SSI *.**■!*, 



ElEKTRA ii i treotinire. el AAA Cnicirjo Ccmpullr Cemer 
FLEI a a IreoeriHl it Itgalcij Siilmi Cuiiullinli 1st 



DSD inn SiaicOi ire Iridetnarlt el Mlcrtwere Seiline Carp 
UHIFLII II iri{lllirianmimarlil lethnitel SVTWM Coniullnitl Int 
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Spreadsheet 
Communications 



Word Processing 



Database 
Management 




FINALLY, 
A PORTABLE OFFICE 

(And A Way to Add IBM-PC/OS9 Compatibility) 



Are you trying to get your persona] and business 
affairs in order when your desk is out of order? 
Are you attempting to operate swiftly, efficiently 
and effectively when your reports, records 
and data are buried under a Matterhom 
of clutter? 



Now, you can clean up your act, by cleaning 
up your desk — because we've put together 
a Corona Portable Computer with Alpha 
Software's "Electric Desk . It's Corona's 
comprehensive, yet simple to use. 
Portable Office Package that allows 
you to concentrate on your work, 
instead of concentrating on trying 
to find your work. 

You get the Corona PPC^JOO. the most 
advanced portable computer that's IBM 
PC compatible. It features a high 
resolution screen (twice the resolution 
of the IBM-PC), a 360K floppy disk 
drive and 256K RAM (with room 
for more drives and RAM). 
And. as you grow, the Corona 
PPC-400 will grow with you. 
It has expansion slots for 
additional PC boards, and 
built-in serial and parallel 
ports so you can add other 
peripherals. 




$ 1195 

AT A VERY 

SPECIAL PRICE 



SMOKE SIGNAL 0&?J£PS/ ^?J# 



31336 Via Colinas, Westlake Village, CA 91362 
PY«me (818) B69-9340 • TLX 91049+4965 



What's more, the system comes complete with 

"Electric Desk" ... a powerful, easy-to-leam and 

use package that includes word processing. 

spreadsheets, database management and 

communications (suggested retail value is $345). 

D3rVt/OS9 COMPATIBILITY — Smoke Signal 
offers a set of programs that brings com- 
patibility to your OS9 computer. When 
you order a Corona PC, we can offer you 
two sets of programs at a very special price 
that provide compatibility between the Corona 
and your OS9 system. The first set of programs 
allows your Smoke Signal OS9 system to list 
the directory, print the contents of a file 
and copy files to and from a disk created 
on the Corona. The second set of 
programs allows the Corona to be used 
as a terminal on Smoke Signal and many 
other OS9 systems and to transmit files 
back and forth between systems. This 
permits the OS9 system to be used as a 
file server for the PC, These two sets of 
programs are normally sold by their 
authors for over 5600. With the purchase 
of a Corona PC, we can offer them to 
you for just $199. 

HARD DISK AND DESK TOP PC's 

an? available at very special prices 

available only to Micro journal readers 

and Smoke Signal customers through 

October 15. Call (818) 889-9340 for 

complete information on pricing and 

available confjgura tions. 

n * irgrttcroii tradrmjri <4 InttvfMltmud Bwnc*» M«t*nf« Im 
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THE 6809 "UNIBOARD"™ 

SINGLE BOARD COMPUTER KIT 

PERFECT FOR COLLEGES. OEMS. INDUSTRIAL 
AND SCIENTIFIC USES! 

64K RAM! DOUBLE DENSITY 
FLOPPY DISK CONTROLLER! 



Hi 



<^ 



eiuf 



BLANK PC BOARD 



$ 99 



95 



WITH PALS, AND 
TWO EPROMS. 

FOR 5-1/4 OR 8 INCH 

SOURCE DISKETTE 

ADD $10. 




$2 19 00 

COMPLETE KIT! 
FULLY SOCKETED. 



PRICE 
CUT!! 



< u* 
Q D 

Shi 

<£CC 

3Z 
OO 

</>" 

H 
£« 

Ss 
It 

ii 

5S 



<5 



THE COMPACTA UNIBOARD": Through special arrangement with COMPACTA INC.. we are 
proud to have been selected the exclusive U.S. Mfg. of their new 6809 UNIBOARD'" COMPUTER 
KIT. Many software professionals feel that the 6809 features probably the most powerful 
Instruction set available today on ANY 8 bit micro. Now, at last, all of that Immense computing 
power is available at a truly unbelievably low price. 



YOUR CHOICE OF POPULAR 
DISK OPERATING SYSTEMS: 

FLEX" from TSC »99 

OS9'" from Microware $199 

Specify 5-1/4 or 8 Inch 



FEATURES: 

* 64K RAM using 4116 RAMS. 

* 6809E Motorola CPU. 

* Double Density Floppy Disk Controller 
for either 5-1/4 or 8 inch drives. Uses WD1793. 

* On board 80 x 24 video for a low cost console. 
Uses 2716 Char. Gen. Programmable Formats. 
Uses 6845 CRT Controller. 

* ASCII keyboard parallel input interface. (6522) 

* Serial I/O (6551) for RS232C or 20 MA loop. 

* Centronics compatible parallel printer interface. 
(6522) 

* Buss expansion interface with DMA channel. 
(6844) 

* Dual timer for real time clock application. 

* Powerful on board system monitor (2732). 

Features commands such as Go To, Alter, Fill, Move, Display, or Test Memory. Also Read 
and Write Sectors. Boot Normal, Unknown, and General Flex'". 



PC BOARD IS 

DOUBLE SIDED, PLATED THRU 

SOLDER MASKED, 11 x 11-1/2 IN. 



Digital Research Computers 

(OF TEXAS) 
P.O. BOX 461S6S . GARLAND. TEXAS 75046 . (214) 225-2309 



TERMS: Shipments will be made approximately 3 to 6 weeks alter we 
receive your order. VISA. MC. cash accepted Add $4 00 shipping 
USA AND CANADA ONLY 
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SOFTWARE FOR 680x SYSTEMS 



SUPER SLEUTH 04SASSEMBLERS 
EACH J99FLEX J101-OS/9 J100-UNIFLEX 

OH ECT-ONLY varalana: EACH 8SO-FLEX r OS/f ,COCO 

mtOfactivaly oarwala tourca on rasfe with UMMh induda tfaf, DtfWy willing 
■pacify ©800,1.2.3.5.8.9^502 varuon Of Z80/80S0.5 version 

0^9 imri aba procaun FlEx lormal gored He u-ioer OS? 

COCO DOS avjaaMa In 6800. 1 .2.3j.B.*«S02 varalon Inol ZB0V8O8O.5} o lly 

CROSS-ASSEMBLERS (TRUE ASSEMBLERS, NOT MACRO SETS) 
EACH *50FLEX,OS'9,UNIFLEX ANY 3 $100 ALL $200 
spadty lOf 180i.BJOZ.at»1.6atM.B«OS.B809.Za.Zeo.8048.»0 1.8083.68000 
trua. modUar, trs»-*lBr»jno arm wamrttm s m C. with kwovuraoad uttMe 
a-orl (not 68000) aouroas Intruded with ail cross ame fablers for ssoo) 

DEBUGGING EMULATORS FOR POPULAR MICROPROCESSORS 
EACH $75. FLEX $100-OS/9 S80-UNIFLEX 
O ECT-OHLY version*: EACH tSO-COCO FLEX.COCO OS/» 
■ sar aur vel / alnuUta prnraraaTe; vtaale rasasaernrj y rarrnaftno, binary aotang 
specify lor 8800(1. (UMBOS, B302. 8809 OM. 280 FVlX 

ASSEMBLER CODE TRANSLATORS FOR 6502, 6800/1, 6609 

8302 10 8809 J75-FLEX J8S-OS/J MO-UNIFLEX 

SSOOfT la San 6 flODS 10 poaloorvind. SJO-FLEX I7S-OSre SB0-UNIFLEX 

FULL-SCREEN XBASIC PROGRAMS wtin coraof eontiol 
AVAILABLE FOR FLEX, UNIFLEX, AND MSOOS 

OtSPt>¥ GEMErWOfVOOCUMEMTOH (SO Waourc*. 125 wMhoul 

MAajNG LIST SYSTEM 1100 nr.'aouree, S$0 without 

INVENTORY WITH MRP 1100 w sour cm, M0 without 

TABULA RASA SFREAOSHEET tl 00 w*ourca. %S0 without 

DtSK AND XBASIC UTI UTV PROGRAM UBRARY 
$50-FLEX $30-UNIFLEX/MSDOS 
son disk aactata, sort diroaory, mjrtjan masw tauv^. do ask eons, 
reBaouanaesomeoreii of BASIC Dn^am, a d BASIC f*uarafn. «tr 
fon-HiXvaraWBrWudaWflardTOuifafenaaonl, 

CMOOEM TELECOMMUNICATIONS PROGRAM 
$100FLEX,OS/9,UNIFLEX 
OBJECT-ONLY versions: EACH »» FLEX, OS'S 
rrwnu-aoVenwantamarBi mode. Ha tractor. MODEM 7. xONxOFF, rjtc, 
to IXCO and n»>COCO. am rani COCO madam port up » 2*00 Baud 



HARDWARE & SERVICES 

525" DISKETTES 
EACH 10-PACK $12.50 SSSD.'SSDD.DSDD J20-DSOD 

A/nrlcao-m ade, OMaranaM l00%qoaary.wieiT)rv*fc tf«*afc, hub *>a«. and lal 

SS-50C256K 1.5MHz MEMORY BOARDS 
EACH BLANK $60 ASSEMBLED AND TESTEO $350 
wtth trcftuoSon manual, aotvnoaa. enddeteylsie^ al pans naasry avaaabte 

AOOmONAL SERVICES FOR TME COMPUTING COMMUNITY 

CUSTOMIZED PROGRAMMING 
wew*adfc*rtai any of tha oroarame daacrtakf mfras raawajiaups or In our 
tsrstiae lor RprtaanBd cteflnnw uaa or to oovor new pna^BMax lha charge 
lor soon cusavrizaaDn depends upon awmarkarabfiny or tna mdfiaokn. 

CONTRA CT PROG RAMMING 
we wil aula new programs or irodVy esfcang. proorama on a osra/acJ oasis. 
aa*\^wotwvepn>^dAdrarovettwarivyaais,v«a»TYijienonwhcftw* 
nave performed cpjarad programtenD wude most popular models of 
<na»e>»-w» , »x»u*»j IBM. Bunoughs. Urtvec, Monsvwaa, mou popular 
matts of meeajnjueax induing rjEC.OM.OG. h*>, AT ST. end most 
papUar Brand* of rmoncompulere. Indurino 6800/1 , 8809, Z80. 6508. 
68000. ustno, moat apsroartrar tanguagal and operating Trn»-o on sytlanm 

i ine*igaiaeia»amiarBaraaai »■ anapia ai nandii Tinaul ■ ■ ■ ill i alaa ■ 

the trios lor mrtrao pr ofltamrrwig iauauVy »y»tal>ouiorbytr»tatK. 

CONSULTING 
waoBarawWaranoaqf busavssandtoohnkalavaaitnQ sawaara. ^otrolng 
aoiw»». aoVKa, lra*»v w d*S7v on any topfc naaud to aai^uwa. 
t» chsnat tor rxnautug * ranvlty haud upon am* . Iravai, and a^ansat 



Computer Systems Consultants, Inc. 

1454 Lstla Lane, Conyers, GA 30207 

Telephone 404-463-1717 or 4570 

We take orders at any lime, but plesse 
plan discussions altar 6, II possible. 

Contact us sboul catalog, dealer, discounts, and services- 
Most programs in source: give computer, OS, disk size. 
25% oft multiple purchases of seme progrsm on one order. 
VISA end MASTER CARD accepted; US lunds only, plesse. 
Add GA ssles tax (If In GA) snd 5% shipping. 

<uNt|FV£X an TaoMatSyuanacaraurani. oss on taooaercCOCO rm Tandy 



SOFTWARE. 
* HARDCORE 



tFORTH® 

from TALBOT MICROSYSTEMS 
NEW SYSTEMS FOR 
6301/6801, 6809, and 68000 



•• FORTH PROGRAMMING TOOLS from Ihe 68XX4X " 
'* FORTH specialists — get ihe best!! " 

NOW AVAILABLE — A variety of rom and disk FORTH systems to 
run on and/or do TARGET COMPILATION lor 

6800. 6301/6801, 6809, 68000. 8080. Z80 

Write or call lor information on a special system to lil your require- 
ment. 

Standard systems available for these hardware— 

EPSON HX-20 rom system and target compiler 

6B09 rom systems lor SS-50, EXORCISER, STD, ETC 

CO OR COMPUTER 

68006809 FLEX or EXORCISER disk syslems 

68000 rom based syslems 

6B0OO CP/M-68K disk syslems. MODEL 11/12,16 

IFORTH is a relined version ol FORTH Inlerest Group standard 
FORTH, lasler than FIG-FORTH FORTH is both a compiler and 
an interpreter. It executes orders of magnitudes faster than inter- 
pretive BASIC. MORE IMPORTANT. CODE DEVELOPMENT 
AND TESTING is much, much faster than complied languages 
s joh as PASCAL and C. If Software DEVELOPMENT COSTS are 
an imporant concern lor you. you need FORTH! 

lirmFORTHc* is lor Ihe programmer who needs to squeeze Ihe 
most into roms. It Is a professional programmer's loo I lor compact 
rommable code lor controller applications 

r* IFOATH and fumFOFTH ara irademspks crl Talbot Microsystems 
*■ FLEX a s trademark of Technical Sysi ms Consuiiants Inc 
- CPM-SBKistradamgrkof Digital Has arch Inc 



— > IFORTH SYSTEMS < - 

For all FLEX syslems: GIMIX, SWTP, SSB, or EXORcisor Specify 
5 or 8 inch diskette, hardware type, and 6800 or 6609 

•• IFORTH — extended fig FORTH (i disk) $100 ($15) 

with fig line editor. 

- (FORTH + — more' (3 5" or 2 8" disks) $250 ($25) 

adds screen edilor. assembler, extended data lypes. utilities, 
games, and debugging aids. 

" TRS-80 COLORFORTH — available from The Micro Works 

'■ firm FORTH — 6B09 only, $350 ($10) 

For target compilations to rommable code 
Aulomalically deletes unused code. Includes HOST system 
source and target nucleus source. No royally on targets, Re- 
quires bul does not include IFORTH 4 . 

" FORTH PROGRAMMING AIDS— elaborate decompiled 50 

" IFORTH lor HX-20, in 16K roms lor expansion unll or replace 
BASIC $170 

" IFORTH68K lor CPM-68K 8" disk system $290 

Makes Model 16 a super sollware development system. 

" Nautilus Syslems Cross Compiler 

— Requires: (FORTH + HOST + at least one TARGET: 

— HOST system code (6809 or 68000) $200 

— TARGET source code: 6800-$200. 6301/6801— $200 
same plus HX-20 extensions — $300 

15809— $300. 8080/Z80— 5200. 68000- $350 

Manuals available separately — price in ( ), 
Add $6. system tor shipping. $15 lor loreign air 



TALBOT MICROSYSTEMS 1927 Curtis Ave.. Redondo Beach, CA 90278 (213) 376 9941 
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WINDRUSH MICRO SYSTEMS 



UPROM II 

PK06KAR5 and VERIFIES: (?7S6, 
72)08, 17716, TZ5H, [2732/2732*, 
MCW97M/6, J7?**'£7*«A, T«M, 
1271?8/271ZSa, and 1272S6. 

1« Intel, T-Terta, «-**o torol*. 

WO PEI.SOHAL.TT 1*0 QUI IS IfcBUIBEBt 

rai-VOLT CPWW APE MOT «UPP0RT€P 

lWTCu'i Intel iStnl prOgraBaing 
(te) iaoieaented for in it i 
Z7«4, 27(28 and 27236 dealer*. 
Intelligent pf greaalng redv-Eei 
thi nferag* prograealng tin* of a 
)764 Iraa 7 alftviet to 1 aintyie 

F1 3 otcondi <under FLIH) w1 th 
greatly ("proved rtUltUHy. 
fully enclosed pod with 
flat ribbon cabte for connection 
to th* Iioat CQaputer HC6621 PIA 
Interface board. 

AX&409 toftvate for ntx and 0S9 
(Lerel 1 or 2, version >.2>. 

Sirurr oi$K riLC offset loader 

tupOHad with FLEX, flDOS and OS«. 

R*nt> driven lofruafa provide* t«» fDUonIng facilities.! 

a. FILL a i*lectrt am of the buffar with a HEX char. 

t>. ffOvC blocks of data. 

c. BUM ........... tht buffer In HEX and ASCII. 

d. FMO ........... a airing of bytes in th* Buffar. 

a. EXAMINC/ChANGE ■ tha centime of the buffer. 

f. C*C chetktuat a selected erea of the buffer, 

g. £0f>Y a selected tree of an EPROf) into the buffer. 

h. vtfllFT ......... a selected area of an tPRDei eealnst the buffer. 

I. PaOfiHAfl ........ a selected area of art fPFOfl ulth data in the buffar, 

j. SELECT ...... a mm EPROft tyee (return to types ftenu) . 

h. ENTER .......... the aystea eonl.or. 

I RETURN to ih* operatic* tystia. 

I. EXECUTE any MS utility (only in FLEl *<*) 0S« versions). 

ftjl mm MB fflfflB jH-ttm mm im »6/«t>os cwIact us direct. 




PL/9 



• Friendly Inter-active environeent where you have jmstamt eccest to the 
fd nor, in* Co*oiler, end the Trace-Debugger, which, eeongat othar 
Ifcinga, cut tingle »teo the prog,*a a SOURCE line at a i lee. Tpu alio 
ha«e direct ecces. to any flfX utility and your vy»tea monitor, 

• J?$* ti«ge aarvuel organised «»» a tutorial with plenty of mvLit. 

• Fan S1H01E PASS cewpiiar products W of (OnPACT and MSI MO? ate Mr* 
code output per etnute aith no rnn-1 la* overhead* or TTcinn fees. 

• Fully coeoatible with T$C taut editor feraet tliik fUth 

• Signed and unsigned 6TIES end Itrfl&ERS, 32-bit floating) point MALI. 

• Vector! (single d1a>ene1on arrays) and POintaM are aupported. 

■ flatheaalical *«pnit1ons: (*i, l->, <*}, </), aodulus (\) # negation <-) 
> Expression evetuotore: C-), Co), <<), C>), <>*!, <<«> 

• Bit OCeretori; CAnO], COR), CEOR/KOR), (NOT), (SHIFT), (SIMP J 

■ Logical oo* retort; (.AND;, (.OR), <„£0*/X0RJ 

• •:." i' ■■. alettaantii U ..THf* il l1.Sl J , ir .. CASH.. CAIE2.. ELSE, HG1K..EMD, 
UHILC.,, RIPEAT.. UNTIL, REPEAT. .fflREvER, CAU, JUMP, RETUtH, ftttAr., SOTO. 

• pirect accest to CACCAj, (UC8>, <ACCO>, <<«tfi), KCRl a.>a (STACK). 

• FUCIV lupporta tKe MCSAO RESET, ml, HRO. IRO, Stfl, SW12, and SKU 
vectort, writing a Ael 1-tt art ing (fro* po*er-yp) progfau that g«e« ANT, 
or ALL, ol the HCAlO? Imerrupta It en absolute tnePl 

• RklchiirHI code «*y be eabadded in the pfograe. via the 'GEN' »tatea>«ni. Th1a 
enablet you to code critical routines in aaseebly tenguage aod eabtd thta 
in thp Pl/v orograa lie* *NAC1i' for d*t»He). 

a Pvocedwret ay be petted and **y return variablet. Thia *>akei thea 
furKtioni which behave et though they ware an Inteqrat pari of Pt/p. 

■ Several full)' dotuaemed librery procedure aodulea »rt »upotied: I0SU8S, 
P1TIO, HAROlO, HE1[0, fLEXlO, SCIPACK^ STRSUBS, SA5T91N5, sncl NEILCCW. 

'... T"1S |S THE HOST EFFICIENT COMPILER 1 ***£ FOUHP TO DATE.' 

fluoted froa Ron A^deriont flEi Uier Notes colum In '6*. 



feed we lay uo-reT 



MACE/XMACE/ASM05 

All of theea producta feature a highly productive envlrenaent ahere the 

■ dvtor and the aaaaaftler ratio* in aeeiory together, tare are the days of 
tedlui dial load and tivt ooeratlorit while you »r» debugging your cod*. 

• friendly Inter-active environment where you have Instant access to the 
Editor and the Asteabler, FlEx utilities and your tystea aonitor. 

■ RACE can alio produce ASHPROCs (CEN *t*1**ont»J for Hf9 with the 
•»it ably language source passed to th* output as coaaantt. 

• HtA<| 1a a trots HiMbLir for th* 6800/1/2/3/6 and supports the extended 

■enaonlcs of the 63D3. 

• * 1*5 la a cross esieaoler for tie 6805, 



D-BUG 



LOOKING for a alngle ttep tracer and alnl irr-llrx dlaatteabler t^at is ea»y 
to utet? Loot no further, you have found It. This Package 1i Ideal l«r 
those saall aiifiably lenguaBe progtaa debugging sessloni. 0-PAPJ occuplit 
lees than fit: (including It a stack end variables) and aay be loadao anywhere 
In aecory. All y«i da It LOAp IT. AtH IT and 60! (80 col VfrUl only). 



McCOSH C 



This 1i as coaplete a 'C ' coapiler as you will find on ony operating systta 
for the 4*09. It it cotvietely co«Patlbl* with UNI* VII and only lecka 
'btt-fleldi' (which are of little Practical uae In an 6-e>1t wortdi). 

• Produce! very efficent eeteably language towrce output ulth me 'C* 
tourer apHonelly interleaved at <*>*a«nti. 

• Hn-M-in optiairer will shorten objirtl code by about 111, 

• Supports, interleaved aaiaably language progrant. 

• IrlCLUBCS its o«n aateabler. The TSC relocating assembler 1i, only r«Qu(r*d 
if you wint 10 generate your own librirles. 

• Ine prc-pracessor, cceapiler # 9pt1s<t*r, asseat>l*r end loader all run 
indep*ndant ly or uridar <*• 'EC' etecutiv*. ' CC aiikai cO«oU*r>o a program 
to eaecwtabla object as Ai*Ple at typing in 'CCHELLo.C <flfTUfiK>-, 



IEEE -488 



SUFfONTS ALL PRINCIPAL HOPES OF THE 1EEE-4M (197$/8) BUS SPEC I * 1CAT ION ; 



TeUir 
' Listener 
Ststen COntrotler 



Serial Poll 
Parallel Poll 
Group Trigger 



- S^nola or bvel Priaary Address 

- Secondary Address 

- Talk only ... Listen only 



Fully docukented with a tOeptete reprint ol the K 11.09 AUP ariiclt an the 
IEEE but end the Motorola publication •Getting aboard tre IEEE Ous' . 

Low level aase*>bly tenguage drivers suitable for 6SO0, 6A01, btOi, 68(73, 
6&0o and 6W? arm supplied in the far* of listings. A cOODlete beck to 
beck test orogra* is al«a aupplied in the fora of « listing. These 
drivers havi been extensively tested and are GUARANTECO to work. 

Single 5-30 boerd It, 8 or 16 addrestea per port), fully socketed, gold 
otatvd but (onn*clori and IEEE interface cable est*at>ly. 



PRICES 

6-BUC C6S09 FLEX only) t 75. 0C 

PUCt CUOT ti.lt only) > ?S.OO 

aiCt C6M9 Fl!> only} 1 9J.0C 

*S"05 C6M9 FLEl only) > 91. DO 

i>U« (HOT FLEI only) 1191.00 

'C 16109 FLEI only) 1295.00 

1EEE-4M with IIEE-4M c.bl. «11.1*ly 1298.00 

UPB3N-3 l/v Hlth ont v«rilon of loftM.rc (n. c«tilf or Int.rt.Ti) .. l59$.0O 

UPHtn-Il/c <■ abov. but cowleti .It. cable and J-50 (ntarfao ....iMS.OO 

:•('.! S 1 t.l»t-o-fLat SO way cabla .1th IK cowactDfa ...... 1 15.00 

S-JO INT SS-50 tntarl.ca lor urtiM-Il 1190.00 

E101 INT Itot.rola ElOlbui (CIOKclaar) Intarfaca lor UPKM-11 ... 1195.00 

UP10H SFT 14lt.art drW.ri for 2nd optrallng 1T1T4*. 

Ipaclly FLEX or 019 ahl dlah alt*! 1 35.00 

UPtOH S8C Aaia*>ly lanoui9« tourca leoniact ui dUact) 

Ill mill lllull III r. « I L r I n I 1 I 

Tar..: CU0. Plroant by Int 1 ! Hon.y Order. VISA cr FULTEaM.Rb alio ictioud, 

Wt STOCK THE FCH.LCTWIMG COMPANtS PftOOUCIS 
Ga«X, S38, FHL, IMCNCtWUC, TSC, LUCtOATA, LLOYD I/O, 

a alfohp a associates. 

FLCX (t.) 1. a tradiHrk of technical [ylt... Corilultantl, 01-? (tO 1. a 

tr«tturt of nlcroueTt IritHit Corporation, mwi (I.) and Iioitii.f Cm) 

art tradaaarai of Ftotorol. tncon»r»t*d. 



WORSTEAD LABORATORIES, NORTH WALSHAM 
NORFOLK, ENGLAND. NR28 9SA. 

TEL: 44 (692) 404086 
TLX: 975548 WMICRO G 
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OK, PLEASE ENTER MY SUBSCRIPTION 
Bill My: Master Charge Q — VISA Q 

Card it Exp. Date ___ 

For □ 1-Year □ 2 Years □ 3 Years 



Enclosed: $ 



Name 



Street_ 

City 



State 



-2'P- 



My Computer ls:_ 



Subscription Retws 
(Effective March 3, 198S) 

U.S.A.: 1 Tear $24.50. 2 Years $42.50. 3 Years $64.50 

* Foreign Swfece: Add $12.00 per Year to USA Price. 

* Foreign Almell: Add $48.00 per Year to USA Price. 

* Canada I Mexico: Add $ 9.50 per Year to USA Price. 

* U.S. Oa-rency Cash or Check Drawn on a USA Bank n 
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STAR-DOS LEVEL I 

Whenever a new DOS is introduced, there's 
always the problem of developing software lo 
work with il. So we did it Ihe opposite way — we 
analyzed Ihe requirements of software that 
already exisls and developed a DOS that mel 
them... and exceeded them! The result is STAR 
DOS Level 1, a new DOS for 6809 systems, ideal 
for single-user industrial, control, and advanced 
hobbyist applications. This includes SS-50 
syslems and single-board computers from a 
variety of vendors. 

Level I is compatible with most current 6809 
hardware and software On the hardware side, it 
allows up lo len floppy or Winchester drives with 
appropriate controllers. On the software side, it 
runs existing 6809 software from all the major 
6809 software suppliers, including TSC, Star 
Kits, lntrol, and others. 

Write or call for more information. STAR 
KITS Software Systems Corporation. P.O. Box 
209. Mt. Kisco NY. 10549 (914) 241 0287. 




TAR-KlTST 



ANDCKSON COFUTER CONSULTANTS 
Associates 



Ron Anderson, respected author and columnist 
for 68 MICRO JOURNAL announces the Anderson 
Computer Consultants A Associates, a con- 
sultlng firm dealing primarily In 68XX(X) 
software design. Our wide experience In 
designing 6809 based control systems for 
machine tools Is now available or a 
consultation basis. 

Our experience Includes programming 
machine control functions, signal analysis, 
multi-axis servo control (CNC) and general 
software design and development. We have 
extensive experience In Instrumentation and 
analysis of specialized software. We support 
all popular languages pertaining to the 6809 
and other 68XX(X) processors- 

If you are a manufacturer of a control or 
measuring package that you believe could 
benefit from efficient software, write or call 
Ron Anderson. The fact that any calculation 
you can do with pencil and paper, can be done 
much better with a microcomputer. We will be 
happy to review your problem and offer a 
modern, state-of-the-art microcomputer 
solution. We can do the entire job or work 
with your software or hardware engineers. 

Anderson Computer Consultants a Associates 

3540 Sturbrldge Court 

Ann Arbor. HI 48105 
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INDUSTRIAL PASCAL 
FOR THE 68OOO 



If you're looking for a language to 
write real-time process control software, 
look no further. With the rising cost of 
labor, it Is becoming critical that a high 
level language be used whenever possi- 
ble. Find out why over 1400 companies 
have switched to OmegaSoft Pascal for 
their demanding applications. 

OmegaSoft Pascal takes the Pascal 
framework and expands the basic data 
types, operators, functions, and memory 
allocation to fit the needs of real-time 
systems. These additions fit in the same 
structure as Pascal and enhance its use- 
fulness without impairing the excellent 
readability, ease of maintenance, and 
structured design. 

The compiler generates assembly lan- 
guage for assembly and link to run on 
the target system. Since a true relocat- 
ing assembler and linking loader is 
used, only those runtime modules re- 
quired are automatically linked in, pro- 
viding a smaller object module than 
other compilers. 

Large Pascal programs can be split up 
into conveniently sized modules to 
speed the development process. Proce- 
dures, functions, and variables can be 
referenced between Pascal modules and 
assembly language modules by using 
Pascal directives. 

The compiler package includes an in- 
teractive, symbolic debugger. The de- 



T M OmegaSol! ts a trademark of Certified Software Corpor- 
ation OS-9/68000 Is a trademark of Microware. VERSAdos is 
a trademark of Motorola CPM-68K Is a trademark of ORI 
UNIX is a trademark of Bell Labs 



bugger allows setting of breakpoints, 
displaying and changing variables, and 
tracing statements. Debugging can also 
be done at the assembly language level 
when needed. The debugger allows very 
fast turnaround for programs to be run 
on the host system (target system de- 
bugger coming soon). 

The compiler package also includes a 
full relocatable macro assembler and 
linking loader. These are designed to 
support the compiler but may also be us- 
ed for general assembly language devel- 
opment. In addition, a full screen editor 
is included which can be used with a va- 
riety of intelligent terminals. 

Full source code is included for the 
runtime library, the debugger, the screen 
editor, and other support utilities. 

Versions to run under the OS-9/68000 
and VERSAdos operating systems are 
currently available to end-users and 
OEM's. End user price is $900 (domestic) 
or $925 (international). A version for 
CP/M-68K is available for OEM use, with 
OEM versions for UNIX type operating 
systems to follow. 

Similar products to run on a 6809 sys- 
tem and generate 6809 code are also 
available for most major 6809 operating 
systems. 



CERTIFIED SOFTWARE 
CORPORATION 

616 Camino Caballo. Nipomo, CA 93444 
Telephone; (805) 929-1395; Telex: 467013 
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Hard Disk Subsystem 
for SS-50 Computers 



TM* provan tuctyttM »4di n*rd diak ap*«i jm stor«*« 
capacity to your covputar ytt rt4uir«a only ont S3-3Q aloe. 
Software (with aouroaJ La Included for your otwlea ot 
fl£X9 a . 03-9* Laval I or Uvel 11. or OS-9 68* os»ratln» 
ayataajs. Tha soft vara honors ail operating aya-toa 
convantlona. Tht aaltyara la daaiftned for the labai 514 10 
controller Intarraeing to any nard disk drive that conform* 
to the 31V06 standard. Four au»ayat«aa are available: 

U 27 MB irornattea) WREN 1 hard di»n, *«bae S1»10 
control lar, S5-30 ini.«r r>c« oard, all oablas, and 
•ortvara Tor 12450; 

21 S MB <roruttad> Shugart 60« hard disk, rest aaaie ta 
above tor >7Sa; 

31 no nard disk, rest aaaa as aoove tor ibOO; and 

t) 33-30 Interface oard ana software for 1200. 
Teiaa raaldanta nuat add dalaa tai. The suoaystw aay be 
■ ountad within your conputar cnassts or in a aaperata 
aricloaure with power auppiy. Pfcaasa write (inolude your 
day ana tvanint phone nueaera) for nora Information. Ve 
will return Morth Warlca calls so that any detailed 
answers will be at our expanse, tfe are proud to announce 
our relocation to the growlni Hlfth-Tach center of the 
Southwest—Austin, we regret that we will ba without 
incoming phone service until our facilities are coepleteo. 

C%T8 X PW S8S 

>.0. Box 9802 - ft*5 
Auetln, laias 78766 

FLEA la a traoeearx of Technical 3yat«ea Conaultanta, Inc. 
03-9 It a treoeaiarjc of Hlcrowara and Motorola 
VBCl la a traoeearjt of Control Data Corporation 



OS-9 

USERS GROUP 

...Information Exchange 

...Software Library 
over 40 diskettes 

...Message Of The Day 
periodic newsletter 

Write or Go OS9 on CompuServe 
for Information 

OS-9 Users Group 

P.O. Box 7506 

Des Moines, IA 50322 

OS-9 It i tradtntrk of Mlcrowara. Inc. 
Ths Ut«ri Group It not ofMIUted with Mleroware 



mm 

Computer Engineers 



POSTUN D, OR 97230 (USA) 
■ TBlfX: MO 3*0 5448 UOYD I O 



10535 NE OUSAN 
PHONE: (503] 666-1097 ■ 

K.BASIC "S wo- 
k-basic It o TSC XBA5IC (XPC) compotlble COMPILES 

tor OS9 & FLEX., price $199 
Here ol lost Is o compiler (or BASIC that wff compile all your 
XBASIC programs K-BASIC COmpllei TSCs XBA9C ond XPC prr> 
atoms to machine code. K-BASIC Is ready now to save you 
money and lime by teaching your Computer ta 

• Think Foster • Conserve Memory • Be Friendlier 

Coll (S03) 666-1097 tar our CATALOG. 
We have marry program* for serious lortwar* d>v*lop*m 

DO T " 

Micro fi4S»C for OS9...S149 

A structured mlrco BASIC for general system control featuring: 
Parameter passing, 10 string variables, 26 numeric variables, 
subroutines, nested loops. Interactive I/O, sequential files, and 
time variables (for applications executing in the background re- 
quired to execute procedures such as disk or Me backups.) in- 
cludes the SEARCH ond RESCUE UI11IIIES'" {For OS9 ONLY.) 



SEARCH and RESCUE UTILITIES 

(orOS9 .. $35 

A super directory seorch utility Output may be ppea to the In- 
cluded utdrHes to perform file COPIES, DELETES. MOVES. LISTING 
(pagination), and FILlEWrG Some tittering utility programs are 
included: of Interest Is the f 1£ DATE CHECKING uttttlec YOUNGER 
and DRAFT (level 2) (For OS9 Level 1 ond 2) 



PATCH™ 

Modem Communications for OS9, 



$39 



PATCH Is a modem communications program for OS9 featuring 
KEV MACROS. ASCII TEXT AND BINARY FILE UP/DOWN LOADING, 
PRINTER COPY, ond HELP MENUS, We use It several times eoch 
day with our TELEX service. PATCH Is convenient ond easy to use. 
Key macros may be pre-stared ond loaded ot ony time 



CRASMB™ 

CROSS ASSEMBLER PACKAGE 

for OS9 & FLEX. ..oil for $399 

Motorola CFVs ...$150 

Intel CPifs . . . $150. Others.. . $150 

CRASMB Is the highly acclaimed cross assembler pockoge for 
OS9 ond FLEX systems. It turns your 6809 computer Into o de- 
velopment station tor these target CPUs; 

6800 6801 6604 6805 6809 6811 6502 
7000 1802 8048 6051 6080 BOSS 28 280 
(68000 16/32 bit eross assembler .. $249) 

CRASM8 features: Moeros. ConaWcro Is. Long symbol names. 
Symbol cross reference tables. Object code In 4 formats {OS9. 
FLEX S 1-S9. IN1EL HEX) 



USA, 



Germany; 
Auitralla 



VtSA, MC. COO. CHIOS, ACCENTED 
UOYD I/O ISM UA W7J, &£. MEDIA ( BOO 3M MOO) 

VNswi (0362 433423). WlnOrvuri |0M2 40S1S9) 

Zocrw Corrv«J*» (43 23 299). K*ll Sorroor* 10*203 4741) 
Porli SocMo tfectronka (344 HM) 



kmsc oastASOManaetsax i/ms 

ftUCKOM»« OY3 OUSMS <632 an *arfo<t*»*J Of UOH0 It} 
OS9UO "orMoonmnexiio " ot rsc 
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CORN 



* 



HYBTaMH BB-BOC 



■0DULE3 - DUt CUDS - IIT3 - ASSEMBLED a TESTEC 
Staekabla Moduli* HI AkT 

30 aaxi POOH SUPPLY a/ fas 

w/Dlek protect ralir 3S0.00 400.00 

DXBE CaBIJTET a/rage, k cablaa 

laaa D1IVSS 200.00 290.00 

•0TB EH BOARD, 6 Sa-oOc. 6 83-30c 

PJU button 329.00 325.00 

Itea Bkra KIT *«T 

in - iittiuopt TtuzR 

1. 10. 100 par aac. 19.99 29. 99 39.99 
n* - IHTILUGEirr port buffer 

31a(la board coaput . 39 . 99 114.99 139. 9S 
DPI* - Dual PIA parallel port, 

4 buffered I/O* 24. 9S 69.99 89. 99 

IADS - Xxteaded Addreeeiag 

BAUD las. PI* port 29.99 69.99 69.99 
MM - MOTHa BOA1D 88-SOe 

a/8AUD fao. 64.95 149.99 199.99 

P1M - 166E PKN DISE 

21. 2764 EPBOka 39.99 79.99 109.69 

rttii • rimira developaent 

2, 6t bloeka 39.99 64.99 114.99 
XMPR - 2764 PROM burnar adapt. 

for 2716 BURNER 19.99 

CBIRBT larboard w/Cablaat 

•6 kar eapaelttae 249.99 

TAXAH 12". 16 Mbl MOHITOR OMSK 149.99 

AMBER 199.99 

4 NODDLE CABI1CIT - uoflatabed 190.00 

POSER SDPPLT v/dlek protect 290.00 

[♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦| 

Color Computer 

MOItOLim - 20 MB* Xoaocbroaa 

video driver 19.00 20.00 

CC30 PORT BUS a/poaar aupply 

9 88-30. 2 Cart 169.99 199.69 

POOB BOX 6 aaltebad outlete 

traoeleat auppreaaloa 29.99 39.99 

RS-232 S.aaltchad porta 

for ebova ADD *20.00 4-29.00 



■paaaaa. Write tor FREE Catalog 

ADO 55.00 StM PER ORDER 
we & £rs WIS. ADO 1 SAl.ES TAX 






A 11931 W. Bluemound Road 
J%& MILWAUKEE. WIS. 53226 
^CBkX.Nc (414)257-0300 
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Dlak-l Flleaort, HlnlciC, Hlnlcopy, Hlnlfas, 

••Llfetlas, "Poetry, "foodllst, "Diet. 
Diak-2 Dlaxedlt w/ 1 ns t . ft fixes, Prime, "Praod, 

"Snoopy, "Football, "Hexpavn,"Hfe t lac 
Dlak-3 Cbug09, Seel, Sec2, Find, TableZ, In text, 

Dlsk-exp, *Dlakaave. 
Dlak-4 Hailing Prograa, "Flnddat, "Change, 

•Teacdlak,. 
D1SK.-3 *D1SKFIX 1, *D1SKFIX 2, "LETTER, 

"L0VESICN, "BLACK JAK, "BOWLING. 
Dlak-» "Purchase Order, Index ( Dlak file lodx) 
Dlak-7 Linking Loader, Rload, Harkneas 
Dlek-a Crteat, Lanpher (Hay 82) 
Diek-9 Date copy, Dl8kflx9 (Aug 82) 
Dlak- 10 Hone Accounting (July 82) 
Dlak-11 Dlaaembler (June 84) 
Dlak.- 12 Hodem68 (Hay 84) 
Dlak-13 *lnitaf68. Teataf68, "Cleanup, »Dskallgn, 

Help, Date.Txt 
Dlak-l* *Inlt, *Test, *Teralnal. "Find, *Dlskedlt, 

Inlt.Llb 
Dtak-13 Hodea9 * Updates (Dec. 84 CUchriac) to 

Hodea9 (April 84 Co— o ) 
Dlek-16 Copy .Txt , Copy. Doc, Cat.Txt, Cat. Doc 
Dlak-17 Hatch Utility, RATBAS, A Basic Preproceaaor 
Dlak- 18 Parae.Hod, Site. Cad (Sept. 85 Araatrong), 

CHDCODE, CMD.Txt (Sept. 85 Spray) 
Dlak-19 Clock, Date, Copy, Cat, PDEL.Aaa ft Doc, 

Errora.Sya, Do, Log.Aam ft Doc. 
Dlak-20 UNIX Like Toola (July & Sept. 85 Taylor & 

Gilchrist). Dragon. C, Crep.C, LS.C, FDUHP.C 
Dlak-2i Utilities a Caaea - Date, Life, Madness, 

Touch, Coblln, Starahot, & IS acre. 
Diak-22 Read CPH * Non-FLEX Dleka. Fraser Hay 

1984. 
Dlak-23 ISAH, Indexed aequentlal file accessing 

aethoda. Condon Nov. 1985. 



Thla la a reader aervlec 0BLT1 No Warranty Is 
offered or laplled, they are as received by 'at* 
Micro Joaraal, and are for reader convenience ONLY 
(aoae HAY Include I lxea or patches). Also 6800 and 
6809 prograaa are alxed, aa each la fairly alaple 
(aoatly) to convert to the other, 

PRICE: 8" Disk $14.95 - 5" Disk: $12.95 

68' HIGIO J001MAL 

POB 794 
Hixson, TN 37343 
615-842-4*00 

* Indicates 6800 

** Indicates BASIC SWTPC or TSC 

6809 no Indicator. 

MASTER CA1D - VISA Accepted 
Foreign — add 10Z for Surface 
or 20Z for Air! 1 
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PT-69 SINGLE BOARD COMPUTER SYSTEMS 
NOW WITH WINCHESTER OR FLOPPY DISK DRIVES 

The proven PT-69 Single Board Computer line is expanding! Systems now can be Winchester or floppy- based Available also in a smaller 
cabinet without drives for dedicated systems with no mass storage requirements. 

' t MHZ 6809E Processor * 2 RS 232 Serial Ports (6850) ' 2 8- bit Parallel Ports (682 1) 

' Timeol-Day Clock " 56K RAM 2K/4K EPHOM ■ 2797 Floppy Disk Controller 




Custom Design lixfuuma Wetcom* 




• pi6ijti wimcheshr srsirn Jt/ssss 

Includes 5 W6 Winchester Drive. Z 40 track OS/00 Drives, 
Parallel Printer Interface • choice ef OS/4 or STAR DOS 

•PT69S7 riOPPY SYSIEM t»959S 

Includes P169 Board. 7 05/00 40 IRK & 1/4' drives, cabinet. 
svltctilnq poser supply. 05/9 or STAR 005 



Floppy Sritim 

• PI 69A ASSEnBltO ft HSICD BOARD 

•OS/9 

•I Aft DOS 



1719 00 
1 700 00 
t SO 00 



VISA MASTERCARD/CHECK, COO 



PERIPHERAL TECHNOLOGY 

1480 Terrell Mill Rd . Suite 870 
Marietta. Georgia 30067 

Telex (6B0S84 404/973-004? 



CAU OA M*UT{ FOX AOCMIOUl 
COWflOUOAIIONS 



XDMS 

Data Management System 
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NEBTCHE8TE 



System Architecture 

W* App Herd Buaineri 
*o*t Office Bo. Ii7 

'iirdiM Manor, tt.f. 10*10 



Tha IDKS 0*T* H*i-.*g*rT>#rn Syatem I*, *,JlUtll# tn thr» J*y*lt. I *t ft 
l ■ - ■ L mclud*l lh# IDKB Autlfuli VMGEM utility And lytterri BMHM ■ » * * l on 
for Ifvil til. ZDHS It on* of In* notl powerful »>*t**» availabl* Far 

(404 coeT4ur*fi *nd A.) t* u*«d *o» a wid* w iirt tt y o* application*, iohs 
utttt irt f*|i«r*^*d in auf del****.* id- **f*ni dntr it-utinn or p> D fuci 

*p>nOunC*ih*nr* *ftd iJlldatlDft 0# Jltf Upgr*d*« *nd «h*in*.*n'*nEe 'tquflll. 

XDM5 l.pvvl 1 con*i*1* of DEFINE, UPDATE in« REPORT facilitia*. 
Thtt level i» ir ttndi*t a* an 'entry level* • y *V*»*ne and pirinil* entry arm 
rppO'tlng o* data on a *t«0uiar' fca*l*. Th* REPORT facility support* 
p*co rd and field **l act ion* *(• la *i«r0** «□> ting . line calculation*, 
column (oral* 4*»d report titllnp. Control >• via a Engl)**.- )i ha language 
«MCn i* upward compatible wit* l«»el tl. XDMS Laval I «IJ*.t> 

XDMS L.v.l II 

L*vdl II add* to L*v*l I th# powerful OEKERATC facility. Thi» facility 
can b* thought of a* a general Ma protests* wnitn can produce report*, 
farina and form teller* a* wall aa fil* output which may be r*. Input to 
th» facility, DEK CRATE m«y ba u**d in CDrnPlei p*oc***.rig application* 
andi if control lad By a Engl i »t -I i *.» co*m*< d language whicni encor*pa**e* 
that u**d By l-*v*| I, IDHS Laval II ........ ( .... . ,*|**.«9 

« DMB Lomwl III 

La**] lit include* All of l*>r*| [I plu* a **l of useful ONS Vtililiet. 
Th**a untitle* in dattgned to aid in tt.a development and maintenance 
Of uaar application* and permit modification of XDMS *y*tem par emeief ». 
input and output of IDHS file*, diapley and modification of flit format, 
graphic 4 up lay a' numtacil data and ntfter f unction*. Laval HI i* 
lnt*riid*d for advanced XDMS uitrt. I0MS Laval 111 ....... . «2»*>.?3 

XDMS Sy»t*» Documentation only <*)0. credit to«*rd pufcnaia). . .ft 2*i93 

X*VCC AccQi-tntino Bv*»*a*m 

Tne X*CC General Accounting Syalea* i* deaipnad for *Pntll bullrlll 
• n«ifO«<M«1i o* uP to 10.000 iccoirntft And invantory it*«n*. Tn.* *y*1*m 
inl*B'ata* accounting function* and invaftory plus th* general ladgar, 
account* r*c*lvaBLa and payabia furicHon* normally told s«parat*ly In 
oihar «y*t*m*. Psaturo* u**> diMnid account *, product* tor tfrvjc*'). 
tr an* action*, invoicing, ate. Easily con* iflur at to float •nvironnmtf. 
XACC C*n*r*l Accounting *,y*t*i* iR*(lvi'** IDMi, pr*f* Lv* llti. . >J**.»5 
XAC< Syai*" Docu-tort talion only i«IO. cradit toward purcha**). . .* ?«.v>» 



WEBTCHEBTER Appllvd B«-imina*m*i Bym«a*ms 
Po*t Offlca Sdi 187, B*iarcliff Manor, K.T, 10510 

All ao'twara I* vrlllan In aicro/iiitaolir and rum under »SQ9 FtW 0/f^ 
Tar***: Ch*c«,, Ho**y Order. Viae or Heeterciherge. Shl|HMA( (Iret cltti. 
U4 P4H $2. SO <|F.M Pox«lfn Swrface or <l).00 roralge A»f). HT ft**, add 
•■III tex. Specify 5" or 8". 



Sal**: ». I. 
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GmX 68020 DEVELOPMENT SYSTEM 

A Multi-user, Multi-tasking software development system for use with all 68000 family processors. 




HARDWARE FEATURES 



• The GMX-020 CPU board has: the MC68020 32-bit processor, a 4K 
Byte no wait-state instruction cache, high-speed MMU, and a lull- 
featured hardware time ot day clock/calendar with battery back- 
up. It also provides tor an optional 68881 floating point co- 
processor. 

• 1 Megabyte of high speed static RAM. 

• Intelligent Serial and Parallel I/O Processor boards significantly 
reduce system overhead by handling routine I/O functions. This 
frees up the host CPU for running user programs. The result is a 
speed up of system performance and allows all terminals to run at 
up to 19.2K baud. 

• The system hardware will support up to 39 terminals. 

• Powered by a constant voltage ferro- resonant power supply that in- 
sures proper system operation under adverse AC power input condi- 
tions. 

• DMA hard disk interface and DMA double density floppy disk con- 
troller are used for data transfers at full bus speed. The DMA hard 
disk drive controller provides automatic 22-bit burst data error 
detection and 11 -bit burst error correction. 

• A selection of hard disk drives with capacities from 19 to 85 
Megabytes, removeable pack hard disk drives, streaming tape 
drives, and floppy disk drives is available. 

UNIX It a Irattmjrk 11 A T A I 

UAm ir«j«m»ni of nit U S GovwnmtM 

Urtf LEX tt i trademark of Tectxilcal SPUnu Communis, trtc 

GMX vk CIMiX aij Vadjira-icJ of GlMIX loc 

GIMIX, Inc.. a Chicago based microcomputer company established in 1975, has produced state of the art microcomputer systems based on Motorola 6300 and 
6809 microprocessors. GIMIX systems are in use in Industry,, Hospitals, Universities, Research Organiations, and by Software Developers. GIMIX was awarded 
the prestigious President's "E" Ceitificate tor Exports in 1984. 



SOFTWARE FEATURES: 

The UniFLEX VM Operating System is a demand-paged, virtual 
memoiy operating system written in 68020 Assembler code for com- 
pactness and efficiency. Any UniFLEX system will run faster than a 
comparable system written In a higher level language. This is impor- 
tant in such areas as context switching, disk I/O. and system call 
handling. Other features include: 

• compact, efficient Kernel and modules allows handling more users 
more effectively than UNIX systems, using much less disk space. 

UNIX system V compatibility at the C source code level. 

C Compiler optimized in 68020 code (optional). 

Record locking for shared files. 

Users can share programs in memory. 

Modeled after UNIX systems, with similar commands. 

System accounting facilities. 

Sequential and random file access. 

Maximum record size limited only by the disk size. 

Multiple Level Directories. 

Up to 4 Megabytes of Virtual Memory per user. 

Optional Languages available are: C, BASIC. COBOL. FORTRAN, 
LISP, PROLOG, SCULPTOR, and ASSEMBLER. In development are 
ADA, PASCAL, and FORTH. 

Included with the UniFLEX Operating System are a Utilities package, 
editor, relocating assembler, linking loader, and printer spooler. Op- 
tions inlcude a fast floating point package, library generator, and a 
sort-merge package. 

The GMX version of the MOTOROLA 020 BUG is included with the 
system. 



Gimix 



1337 WEST 37th PLACE • CHICAGO, ILLINOIS 60609 



(312)927-5510 



TWX910-221-405S 
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Fof Ordarlng Call 



(615)842-4600 

FROM - DATA-COMP, C.P.I. 



A Family of 100% 68XX Support Facilities 
The Folks who FIRST Put FLEX*' on 

The CoCo 

Now Offering +FLEX" (2 Versions) 

AND 'STAR-DOS PLUS+ '" 
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STAR DOS PLUS + 

• Functions Same as FLEX 

• Reads - writes FLEX Disks 

• Run FLEX Programs 

• Just type: Run "STAR-DOS" 

• Over 300 utilities & programs 
to choose from. 



PLUS 



TSC Editor 




RfH 15»M> 




NOW St', OO 
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ALL VERSIONS OF FLEX & STAR-DOS* INCLUDE 




♦ Read Write- Dir RS Disk 
+ Run RS Basic from Both 
+ More Free Utilities 
+ Many Many More!!! 



+ External Terminal Program 
+ Test Disk Program 
+ Disk Examine & Repair Program 
+ Memory Examine Program 



TSC Assembler 

NOW 5.00 



riuHti NiF'.k Ilnve Systems 



NEW LOWER PRICES ON PAR «. AND PRIfTDtS 

THESE PACKAGES INCLUDE DRIVE, 'CONTROLLER, 
POWER SUPPLY * CABINET. CABLE. AND MANUAL. 

* SPECIFT WHAT CONTROLLER TOO WANT Mm. OR RADIO SBMX. 

PAR fl - 1 SINGLE SIDCO. OOUBLE 0ENS1TT STS. (349.95 

MI #1 - 1 SINClt SIDCD. OOUBLE 0ENS1TT STS. (639.95 

NIH-1 DOUBLE SIDCO. OOUBLE OENSITT STS. (439.95 

PAR #4 - 2 DOUBLE SIKO. OOUBLE OENSITT STS. (699.95 
WH-i DOUBLE SIDCO, OOUBLE DENSITT STS. 

THINLINE ORITES, HALF SIZE M*».*S 



D 



Controllers 



J*H D1W CONTROLLER H/ JOOS OR RADIO SMACK 
DISK BASIC, SPECIfT WHAT OISR BASIC. 



RADIO SHACK DISK CONTROLLER l.J 



•134.05 
$134. 9S 



64K UPGRADE H/HOD. INSTRUCTIONS, 

c.o.c.r, ano coco z s 44.9s 

HJL KETBOAROS ( 74,95 

MICRO TECH LOWER CASE ROM ADAPTER t 74.95 

RAOIO SHACK BASIC 1.2 S 24. 9S 

RADIO SMACK OISK BASIC 1.1 ( 24.95 

DISK 0R1YE CABINET t POWER SUPPLT S 49.95 

SINGLE SIDED. OOUBLE OENSITT 5* OISK DRIVE S199.95 

OOUBLE SIDCO, OOUBLE OENSITT 5' OISK DRIVE S249.9S 



Printers 



EPSON RX-8D 
EPSON RX-BOFT 
EPSON MX- 100 
EPSON FX-100 
EPSON FX-80 
EPSON Ml -70 



isl. Drive Cables 



CABLE FOR ONE ORITE 
CABLE FOR TWO DRIVES 



1269.00 
(369.00 
(499.00 
$799.00 
(549.00 
(200.00 



( 19.95 
( 24.95 



DATA-COMP 

5900 Cassandra Smith Rd 
Hixson. TN 37343 
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SHIPPING 

USA ADD 2% 

FOHCI6N ADD SSI 

niN. S2.SO 


(615)842-4600 

For Ofd«flng 

TELEX SS« 414) PVT BVTH 
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HON AVAIIASLE TO ALL S50/68XX USERS 
The Dato-Corap Division of CPl Is proud to announce the availability 
of their service department facilities to 'ALL' S50 Bus and 68XX 
users. Including all brands, SWTPC - GIHIX - SS6 - HELIX and 
others. Including the single board computers. * Please note that 
klt-bullt components are a special case, and will be handled on en 
Individual basis, If accepted. 

1. If you require service, the first thing you need to do Is call 
the number below anil describe your problem and confine a tete-O^ 
service I shipping ni— If I This Is very Important, Oata-Comp will 
not accept or repair Items not displaying this number! Also we 
cannot advise or help you troubleshoot on the telephone, we can 
give you a shipping number, but NO advice! Sorryl 

2. All service shipments must Include both a minimum 140.00 
estimate/repair charge and pre-paid return shipping charges 
(should be same amount you pay to ship to Data-Camp). 

3. If you desire a telephone estimate after your repair Item Is 
received. Include an additional 15.00 to cover long distance 
charges. Otherwise an estimate will be mailed to you. If you 
requested an estimate. Estimates must be requested . Mailed 
estimates slow down the process considerably. However, If repairs 
are not desired, after the estimate Is given, the 140.00 shall 
constitute the estimate charge, and the ltem(sl will be returned 
unrepaired providing sufficient return shipping charges were 
Included with Item to be serviced. Please note that estimates are 
given In dollar amounts only. 

4. Date-Coap service Is the oldest and most experienced general 
S50/68XX service department In the world. We have over 
1100,000.00 In parts In stock. We have themost complete set of 
service documents for the various S50/68XX systems of anyone - 
YET, HE DO NOT HAVE EVERYTHING* But we sure have more than anyone 
else. We repair about 90$ of all Items we receive. Call for 
additional Information or shipping Instructions. 
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